Single-page portfolio layout with four content sections: intro, projects, about, and contact
gatsby-portfolio — Gatsby Portfolio Template
By Johnny-Lira
A Gatsby-based single-page portfolio starter using the @lekoarts/gatsby-theme-cara theme, with parallax and shape animations, and content defined by MDX files.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Uses the @lekoarts/gatsby-theme-cara theme, customized by shadowing theme files
Theme UI-based theme configuration, with files under src/gatsby-plugin-theme-ui/ available for overriding
Parallax effects implemented with react-spring, plus CSS animations for shapes
Content written in MDX, with project cards configured via the <ProjectCard /> component for title, link, and background
Template Details
This project is a Gatsby portfolio starter. The repository states it is built on the @lekoarts/gatsby-theme-cara theme, presenting a single-page, colorful portfolio page with parallax effects and animations. The demo site is cara.lekoarts.de.
Content organization: page content is defined by four .mdx files in the theme's sections directory: intro.mdx, projects.mdx, about.mdx, and contact.mdx; this starter already overrides intro.mdx as an example. Project cards must be rendered in projects.mdx using the <ProjectCard /> component, which accepts props such as title, link, and bg.
Customization: override theme files via Gatsby's theme shadowing mechanism, typically by placing files under src/@lekoarts/gatsby-theme-cara/; Theme UI configuration is adjusted by overriding files in src/gatsby-plugin-theme-ui/. The static directory contains icons, social share images, and robots.txt, which you need to replace yourself.
Usage limitations: the repository provides no additional guarantees beyond the MIT license; third-party assets such as demo images, fonts, and icons require separate license verification. Issue feedback in the README points to the upstream theme repository LekoArts/gatsby-themes, not this repository.
Is it right for your project?
Use Cases
- Build a single-page personal portfolio to showcase project cards and a personal introduction
- Learn or practice theme override customization through Gatsby theme shadowing
- Serve as a starting point for a portfolio page requiring parallax and shape animation effects
- Maintain portfolio copy and project entries through MDX files
Suitable For
- Developers familiar with Gatsby and MDX who want to quickly start a portfolio page
- Users who need a single-page structure and accept customization via theme shadowing
- Users willing to replace the icons and social images in the static directory themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Create a site with Gatsby CLI: gatsby new project-name https://github.com/LekoArts/gatsby-starter-portfolio-cara
- 2
After entering the directory, run gatsby develop; the local address is http://localhost:8000
- 3
Before customizing, read the Gatsby theme Shadowing documentation and place override files in src/@lekoarts/gatsby-theme-cara/
- 4
Content changes correspond to intro.mdx, projects.mdx, about.mdx, and contact.mdx in the theme's sections directory
- 5
Replace the icons, social share images, and robots.txt in the static directory
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- You may use, modify, commercialize, and distribute the code of this version for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The README provides a Patreon sponsorship link, which is voluntary support and not a usage restriction; you can use the project fully without paying.
- The author provides contact information for paid freelance/contract work, which is an optional commercial service and does not affect free use under the MIT license.
- Issue feedback must go to the upstream theme repository LekoArts/gatsby-themes, not this starter repository.
- The static directory contains icons, social share images, and robots.txt, which you need to replace yourself; the licenses for these assets require separate verification.
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses; you cannot judge solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
consider supporting me on [Patreon](https://www.patreon.com/lekoarts)!
Original README
If you want to hire me for **contract/freelance work**, you can do so!
Original README
Please open up an issue on the main repository: [LekoArts/gatsby-themes](https://github.com/LekoArts/gatsby-themes).
Original README
https://github.com/Johnny-Lira/gatsby-portfolio/blob/master/LICENSEhttps://github.com/Johnny-Lira/gatsby-portfolio/blob/master/README.mdThe `static` folder contains the icons, social media images and robots.txt. Don't forget to change these files, too!
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 70 / 100
- Technologies
- Gatsby · React
- Website type
- Portfolio · Starter
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2023-06-10
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Gatsby as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: ff81ec570e5cd47dd4956790567ceaceeed83ef044cc744a8086f3b5334c45bb
2026-10-03T22:29:59.491Z
Source file / repository<p align="center">
<a href="https://cara.lekoarts.de">
<img alt="LekoArts" src="https://img.lekoarts.de/gatsby/gatsby-site-illustration.png" />
</a>
</p>
<h1 align="center">
Gatsby Starter Portfolio: Cara
</h1>
<p align="center">
<a href="https://github.com/LekoArts/gatsby-starter-portfolio-cara/blob/master/LICENSE">
<img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Gatsby Starter Portfolio: Cara is released under the MIT license." />
</a>
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome!" />
<a href="https://twitter.com/intent/follow?screen_name=lekoarts_de">
<img src="https://img.shields.io/twitter/follow/lekoarts_de.svg?label=Follow%20@lekoarts_de" alt="Follow @lekoarts_de" />
</a>
<a href="https://app.netlify.com/sites/portfolio-cara/deploys">
<img src="https://api.netlify.com/api/v1/badges/88bbaef1-6f83-4894-8acd-e6512ff39265/deploy-status" alt="Netlify Status" />
</a>
</p>
Playful and Colorful One-Page portfolio featuring Parallax effects and animations. Using the Gatsby Theme [`@lekoarts/gatsby-theme-cara`](https://github.com/LekoArts/gatsby-themes/tree/master/themes/gatsby-theme-cara).
[**Demo Website**](https://cara.lekoarts.de)
Also be sure to checkout other [Free & Open Source Gatsby Themes](https://themes.lekoarts.de)
## ✨ Features
- Theme UI-based theming
- react-spring parallax effect
- CSS Animations on Shapes
## 🚀 Getting Started
[](https://app.netlify.com/start/deploy?repository=https://github.com/LekoArts/gatsby-starter-portfolio-cara) [](https://codesandbox.io/s/github/LekoArts/gatsby-starter-portfolio-cara/tree/master/)
1. **Create a Gatsby site.**
Use the Gatsby CLI to create a new site, specifying this project
```sh
gatsby new project-name https://github.com/LekoArts/gatsby-starter-portfolio-cara
```
2. **Start developing.**
Navigate into your new site's directory and start it up.
```sh
cd project-name
gatsby develop
```
3. **Open the code and start customizing!**
Your site is now running at `http://localhost:8000`!
If you want to learn more about how you can use a Gatsby starter that is configured with a Gatsby theme, you can checkout this [shorter](https://www.gatsbyjs.org/docs/themes/using-a-gatsby-theme/) or [longer](https://www.gatsbyjs.org/tutorial/using-a-theme/) tutorial. The tutorials don't exactly apply to this starter however the concepts are the same.
## 📝 Using and modifying this starter
**Important Note:** Please read the guide [Shadowing in Gatsby Themes](https://www.gatsbyjs.org/docs/themes/shadowing/) to understand how to customize the underlying theme!
This starter creates a new Gatsby site that installs and configures the theme [`@lekoarts/gatsby-theme-cara`](https://github.com/LekoArts/gatsby-themes/tree/master/themes/gatsby-theme-cara).
Have a look at the theme's README and files to see what options are available and how you can shadow the various components including Theme UI. Generally speaking you will want to place your files into `src/@lekoarts/gatsby-theme-cara/` to shadow/override files. The Theme UI config can be configured by shadowing its files in `src/gatsby-plugin-theme-ui/`.
### Changing content
The content of this project is defined in four `.mdx` files inside the theme's `sections` folder. You can override the files `intro.mdx`, `projects.mdx`, `about.mdx` and `contact.mdx`. This starter has overriden the `intro.mdx` file as an example. Place the other files in the same `src/@lekoarts/gatsby-theme-cara/sections/` folder.
You have to use the `<ProjectCard />` component inside `projects.mdx` to display the cards. Example:
```md
## Projects
<ProjectCard title="Freiheit" link="https://www.behance.net/gallery/58937147/Freiheit" bg="linear-gradient(to right, #D4145A 0%, #FBB03B 100%)">
This project is my entry to Adobe's #ChallengeYourPerspective contest.
</ProjectCard>
```
### Change your `static` folder
The `static` folder contains the icons, social media images and robots.txt. Don't forget to change these files, too!
## 🤔 Questions or problems?
Please open up an issue on the main repository: [LekoArts/gatsby-themes](https://github.com/LekoArts/gatsby-themes). Thanks!
## 🎓 Learning Gatsby
Looking for more guidance? Full documentation for Gatsby lives [on Gatsby's website](https://www.gatsbyjs.org/).
### Themes
- To learn more about Gatsby themes specifically, we recommend checking out the [theme docs](https://www.gatsbyjs.org/docs/themes/).
### General
- **For most developers, I recommend starting with the [in-depth tutorial for creating a site with Gatsby](https://www.gatsbyjs.org/tutorial/).** It starts with zero assumptions about your level of ability and walks through every step of the process.
- **To dive straight into code samples, head [to Gatsby's documentation](https://www.gatsbyjs.org/docs/).** In particular, check out the _Reference Guides_ and _Gatsby API_ sections in the sidebar.
## 🌟 Supporting me
Thanks for using this project! I'm always interested in seeing what people do with my projects, so don't hesitate to tag me on [Twitter](https://twitter.com/lekoarts_de) and share the project with me.
Please star this project, share it on Social Media or consider supporting me on [Patreon](https://www.patreon.com/lekoarts)!
If you want to hire me for **contract/freelance work**, you can do so! [Get in touch with me!](https://www.lekoarts.de/en/contact)
Explore similar templates
Compare previews and descriptions within the same stack and category.

gatsby-starter-gcn
A Gatsby starter for building static blogs with Contentful and Netlify.
Gatsby · Blog

yashitanamdeo.github.io
A Gatsby and React personal portfolio template with a dark theme and navy blue and green accents, based on Yashita Namdeo's first personal homepage.
Gatsby · Portfolio

gatsby-starter-morning-dew
A Gatsby and React blog starter/theme that uses Markdown or MDX for posts, supports multilingual content, dark mode, tag grouping, PWA, and Disqus comments, and is MIT licensed.
Gatsby · Blog

starter-gatsby-blog
A community-maintained Gatsby blog starter for Contentful, with a simple content model, npm run setup import, Sync API support, and gatsby-plugin-image. Suitable for quickly building a CMS-driven static blog or learning Gatsby and Headless CMS integration.
Gatsby · 社区

automatic-gatsbyjs-app-landing-page
A GatsbyJS template for iOS app landing pages, ported from Emil Baehr's Automatic App Landing Page. Configure content in site-config.js without writing HTML or CSS, upload video previews or screenshots, and deploy via Netlify or build for GitHub Pages.
Gatsby · Tool Site

gatsby-starter-cv
A Gatsby and React starter for building a responsive personal digital resume. It includes sections for About, Skills, Job experiences, GitHub repositories, and Portfolio, with all personal data configured in data/siteConfig.js.
Gatsby · Starter
