Community Plugin

@raae/gatsby-plugin-starter

A starter to bootstrap your next Gatsby Plugin
— automatic release to npm with semantic-release out of the box

Heads up: This package is NOT to be used as a Gatsby Plugin; it’s a template for you to bootstrap your own plugin.

A message or two or three from Queen Raae 👑

1-on-1 Emergency Gatsby Call

Are you stuck on a reef in the sharky waters around the Gatsby islands? Check out 1-on-1 Emergency Gatsby Call with Queen Raae to get friendly advice you can put into action immediately from a seasoned Gatsby developer.

Stay updated and get the most out of Gatsby

Learn how to get the most out of Gatsby and stay updated on the template by subscribing to daily emails from Queen Raae and Cap’n Ola.

Video Walkthrough

Watch Queen Raae use this starter to create a new Gatsby plugin in a unauthorized and rum-fueled treasure hunt in the sharky waters around the Gatsby islands on YouTube.

Create your next Gatsby Plugin

Get started

Use this template to create a new repository based on the code in this repository, but with a clean history. There is no need to drag all the commits of this repository by forking.
Select the correct owner and give it a name according to the Gatsby Plugin naming standard.

Note: You will get a message about failing releases, this is expected and will sort itself out when you are ready for your first release.

Make it yours

Clone your new repository onto your machine
Make the readme template the root template (mv README_TEMPLATE.md README.md)
Delete the changelog (rm CHANGELOG.md)
Search and replace @raae/gatsby-plugin-starter with the name of your plugin
Search and replace github.com/queen-raae/gatsby-plugin-starter with the link to your repository
Search and replace queen@raae.codes with your email address
Search and replace @raae with your GitHub username
Change the description in plugin/package.json
Change the tag line in README.md
Run yarn install
Commit changes git commit -a -m "chore: rename all the things"
Create an initial tag (git tag v0.0.0 -a -m "Initial tag") and push it (git push origin --tags)

Develop and test

Check the CONTRIBUTING.md file.

Release

The project uses conventional commits and semantic versioning to automate releases by utalizing the semantic-release project and GitHub Actions.

As the project owner, you need to add an NPM token to your repository secrets so that Semantic Release can do its thing 💪

Create an automation access token on npmjs.com/ (Avatar -> Access Token).
Add NPM_TOKEN to your repository secrets (Settings -> Secret -> Action) with the value from above.

Semantic Release Settings

Commits to the main branch will result in a new release while committing to a next branch will result in a pre-release. The releases follow Semantic Versioning, and your commit messages will decide the following version number.

Commits message titles prefixed by fix:, fix(<scope>): and docs(README): will result in a patch version update
Commits message titles prefixed by feat:, feat(<scope>): will result in a minor version update
Commits message footers containing BREAKING CHANGE: or BREAKING CHANGES: will result in a major version update

In addition to automating releases, Semantic Release creates and updates a CHANGELOG.md based on the above commit rules.

Check the .releaserc file, the .github/workflows/release.yml and the Semantic Release documentation for more details.

Questions, Feedback, and Suggestions

If you have any questions, feedback, or suggestions, head on over to discussions.

Found a bug?

If you find a bug, please open an issue and create a pull request to fix it if you are able.