Back to templates

Template details

Gatsby Starter Storybook

Gatsby v2 starter with Storybook v5, styled-components, ESLint, and Netlify deployment.

About this template

Gatsby Starter Storybook is a boilerplate starter for building Gatsby v2 sites with Storybook v5, styled-components, and a preconfigured ESLint setup, giving developers a ready-to-run structure for component-driven development.

What is Gatsby Starter Storybook?

This starter is a GitHub repository authored by Marko Radak (as stated in the license) that boots a new Gatsby v2 project with Storybook v5 preinstalled. It takes a machine with Node and the Gatsby CLI, and via a single gatsby new command produces a fully scaffolded site with styled-components for theming. Specifically, the starter includes Gatsby v2 as the static site generator, Storybook v5 for isolated component development, Styled Components v4 for CSS-in-JS, Styled Reset for base styles, Netlify configuration, and ESLint for code linting. It is packaged as an MIT-licensed open-source repository on GitHub.

Key Features

  • Gatsby v2 — The starter uses Gatsby v2 as its static site generator, enabling fast, React-based static sites.
  • Storybook v5 — Includes Storybook v5 for developing UI components in isolation.
  • Styled Components v4 — Uses Styled Components v4 for CSS-in-JS styling.
  • Styled Reset (Advanced) — Provides a preconfigured advanced reset to normalize base styles.
  • Netlify Configuration — Includes Netlify configuration for one-click deploy via the Deploy to Netlify button.
  • ESLint — Ships with an ESLint setup for consistent code quality.
  • Quick Scaffolding — Bootstrap a new project with gatsby new and the repository URL.
  • MIT License — Released under the MIT License, free to use and modify.

Who is it for?

  • Front-end developers who want to start a Gatsby site with Storybook already configured for component-driven development.
  • Design system teams that need an isolated environment to develop and document UI components within a Gatsby ecosystem.
  • Developers deploying to Netlify who benefit from a built-in deploy configuration.

Use cases

  • Prototyping a Gatsby site: Scaffold a new blog or marketing site and start building components immediately.
  • Building a component library: Use Storybook to develop and test components separately before wiring them into Gatsby pages.
  • Team project kickoff: Hand the starter to a team to ensure consistent tooling (styled-components, ESLint) from day one.

How does it work?

  1. Run gatsby new my-awesome-site https://github.com/markoradak/gatsby-starter-storybook to scaffold the project.
  2. Navigate into the project with cd my-awesome-site.
  3. Run yarn start or yarn develop to start the development server.
  4. Deploy to Netlify by clicking the Deploy button, which uses the included configuration.

FAQ

  • Is Gatsby Starter Storybook free? Yes, it is open source under the MIT License.

  • What Gatsby version does it use? Gatsby v2, as specified in the starter.

  • What styling solution is included? Styled Components v4 with an advanced styled reset.

  • Does it support Netlify deployment? Yes, it includes Netlify configuration and a one-click deploy button.

  • Can I use it with Yarn? Yes, the quick start commands use yarn start or yarn develop.