The smallest possible Gatsby theme

Quick Start

1mkdir my-site
2cd my-site
3yarn init
4# install gatsby-theme-minimal and it's dependencies
5yarn add gatsby react react-dom gatsby-theme-minimal

Then add the theme to your gatsby-config.js. We'll use the long form here for education purposes.

1module.exports = {
2  __experimentalThemes: [
3    {
4      resolve: "gatsby-theme-minimal",
5      options: {}
6    }
7  ]
8};

That's it, you can now run your gatsby site using

1yarn gatsby develop

Note that this site doesn't do anything, so you're see a missing resources error. Create a simple page in src/pages/index.js to see a page on the root url.

1import React from "react";
2
3export default () => <div>My Site!</div>;

Doing more with themes

You can use this as a place to start when developing themes. I generally suggest using yarn workspaces like the gatsby-theme-examples repo does, but using yarn link or npm link is a viable alternative if you're not familiar with workspaces.