Welcome! This document will give you an overview of the technology behind this project and show you how you can contribute.
These are the tools that we're using in this project.
- Fork the repository and clone it to your machine
- Install the global dependencies:
gatsby-cli
,eslint
,stylelint
, andcommitizen
- e.g.
yarn global add gatsby-cli eslint stylelint commitizen
- e.g.
- Use the following commands as needed:
- To run the dev server:
yarn run develop
- To build for production:
yarn run build
- this step is handled automatically for our repo
- To lint your code:
yarn run lint
- To test your code:
yarn run test
- To run the dev server:
- Create a pull request with your changes
- Address any issues brought up by maintainers
- Your changes will be automatically deployed to
gh-pages
upon a successful merge withmaster
- Your changes will be automatically deployed to
To contribute to this project, you must conform to the following standards.
- Javascript/JSX style guide
- CSS style guide
- stylelint-config-standard
- extras (view
.stylelintrc
)
- conventional-changelog
- Required: use commitizen through
git cz
when commiting- Our repository is preconfigured to be commitizen-friendly
- Commits that do not conform the the
conventional-changelog
standard will not be accepted