Gatsby Starter Stellar is a free, open-source starter template for building static websites with Gatsby.js V2, reproducing the Stellar site design created by HTML5 UP and maintained by codebushi.
What is Gatsby Starter Stellar?
Gatsby Starter Stellar is a Gatsby.js V2 starter project that takes the Stellar site template designed by HTML5 UP and wraps it in a modern React-based static site generator. It provides a complete project scaffold you can install with a single command, then customize to produce a static one-page site. The repository is maintained by codebushi, who publishes Gatsby starters and themes on their site at https://codebushi.com/gatsby-starters-and-themes/. A live preview of the starter is hosted at https://gatsby-stellar.surge.sh/. An older version of the starter built for Gatsby V1 is preserved in the V1 branch of the repository.
Key Features
- Gatsby.js V2 support — The starter is updated for Gatsby V2, using its component-based build system for fast static sites.
- Stellar design — The template replicates the Stellar layout by HTML5 UP, a minimal single-page design with a prominent intro section.
- One-command installation — Install by running
gatsby new gatsby-starter-stellar https://github.com/codebushi/gatsby-starter-stellarfrom the CLI. - Rapid local development — Run
gatsby developto start a development server with hot reloading for live edits. - Live preview — A working demo is available at gatsby-stellar.surge.sh so you can see the default output before installing.
- V1 branch — The earlier Gatsby V1 version of the starter is stored separately for users who have not yet migrated.
Who is it for?
- Front-end developers — Developers who want a pre-built React/Gatsby project structure instead of starting from scratch, and who plan to customize the design.
- Portfolio builders — Anyone who needs a clean, single-page personal site to showcase projects or a resume, using the Stellar visual style.
- Gatsby learners — People learning Gatsby V2 who want a small, working starter to inspect and experiment with.
What can you do with Gatsby Starter Stellar?
- Build a personal portfolio — Customize the intro, sections, and styling to present your work on a one-page site that compiles to static HTML and CSS.
- Create a project landing page — Use the starter as a landing page for a GitHub project or open-source tool, pointing visitors to your repo and other links.
- Study a Gatsby V2 project — Dig into the file layout of the starter to understand how pages, components, and assets are organized in a typical Gatsby site.
How does Gatsby Starter Stellar work?
After installing the starter, gatsby develop launches a local dev server at localhost:8000 where you can edit the source files and see changes instantly. The project uses Gatsby's standard build process, so running gatsby build produces a static site ready to deploy to any static host such as Netlify or Surge.sh.
FAQ
How do I install Gatsby Starter Stellar?
Run gatsby new gatsby-starter-stellar https://github.com/codebushi/gatsby-starter-stellar from your terminal, assuming you already have Gatsby installed. This clones the repository and installs dependencies automatically.
What version of Gatsby does this starter use?
The current version is built for Gatsby.js V2. If you need the older Gatsby V1 version, it is available in the V1 branch of the GitHub repository.
Where can I see a live preview?
A live demo is hosted at https://gatsby-stellar.surge.sh/. You can view the default template there before deciding to install it.
What design template is this based on?
The starter is based on Stellar, a site template designed by HTML5 UP. The Gatsby starter reproduces that design with React components.
How do I start the development server?
Navigate into the project directory and run gatsby develop. This starts a development server with hot reloading at http://localhost:8000.
