gatsby-opinionated-starter

A very opinionated TypeScript netlify-ready gatsby starter

Usage no npm install needed!

<script type="module">
  import gatsbyOpinionatedStarter from 'https://cdn.skypack.dev/gatsby-opinionated-starter';
</script>

README

Opinionated Gatsby Starter

TypeScript · jest · testing-library · Storybook
ESLint + airbnb · stylelint · remark-lint · Prettier
commitizen · commitlint · semantic-release
Netlify-ready · GitHub Actions · Renovate · TypoCI · PWA-enabled · Typography.js

Github Actions Build Status npm version code style: prettier

Very opinionated starter for Gatsby

This is a complex boilerplate for Gatsby with conventional commits.

Supports:

🚀 Quick start

  1. Create a Gatsby site.

    Firstly, you need to install Gatsby CLI on your machine:

    $ npm i -g gatsby-cli
    

    Use the Gatsby CLI to create a new site, specifying a starter.

    # create a new Gatsby site using this starter
    $ gatsby new opinionated-project https://github.com/datacrafts-io/gatsby-opinionated-starter
    
  2. Start developing.

    In order to run Storybook + Gatsby dev server, navigate into your new site’s directory and start it up.

    $ cd opinionated-project/
    $ npm i -D husky
    $ npm run start
    
  3. Committing.

    In order to commit in a conventional style conveniently you may run npm run commit.

:warning: Disabling publishing to npm

There is a file .releaserc.json where you can disable publishing your project to npm on every new semantic release by setting npmPublish option to false

🎓 Learning Gatsby

Looking for more guidance? Full documentation for Gatsby lives on the website. Here are some places to start:

  • For most developers, it is recommended starting with official in-depth tutorial for creating a site with Gatsby. 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 official documentation. In particular, check out the Guides, API Reference, and Advanced Tutorials sections in the sidebar.

💫 Deploy

Deploy to Netlify

Deploy with Vercel