Skip to content
A minimalist Gatsby theme for writers
Branch: master
Clone or download
Pull request Compare This branch is 22 commits ahead of jlengstorf:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Gatsby Theme Writer

This is a minimal blogging theme intended to focus on content and readability.

See the live demo.


To use this theme in your Gatsby sites, follow these instructions:

  1. Install the theme

    npm install --save @beccanelson/gatsby-theme-writer
  2. Add the theme to your gatsby-config.js:

    module.exports = {
      plugins: ["@beccanelson/gatsby-theme-writer"]
  3. Start your site

    gatsby develop


You can configure your site metadata in gatsby-config.js. Optionally, you can also configure your basePath, contentPath, and assetsPath.

Example configuration:

module.exports = {
  siteMetadata: {
    title: "My Gatsby Site",
    author: "Becca Bailey",
      "A short description of your site. This will appear in your bio.",
    siteUrl: "",
    social: {
      twitter: "my-twitter",
      instagram: "my-instagram"

If you would like to add an avatar, the bio component will look for a file named avatar.[jpeg|jpg|gif|png]. This should go in your assets folder.

Adding Blog Posts

This theme currently supports markdown posts. For more information about markdown syntax, check out this guide.

To keep a post organized witn its assets, we can create a folder structure like this:


In addition to the markdown content, each post needs frontmatter in order to display and categorize it.

title: My First Blog Post!
date: "2019-07-28"
featuredImage: "./featured.jpg"
featured: true

For more information, see the demo/ in this repository.

Featured Posts

To add a post to the featured posts module, set featured to true in the post frontmatter. Also, for best results make sure you have set a featured image for the post. This module supports up to two featured posts at a time. Note: these posts will still appear in the main posts list as well.


If you would like to make changes to this theme, you can use the demo theme to help you out.

git clone
cd gatsby-theme-writer

Install your dependencies


Start the demo

yarn workspace demo start

Additionally, you can customize your own theme using child theming and component shadowing.


If you are using this theme, I appreciate issues and pull requests! Fork this repo, and follow the setup instructions above to contribute.

You can’t perform that action at this time.