Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
42 lines (26 loc) · 1.88 KB

CONTRIBUTING.md

File metadata and controls

42 lines (26 loc) · 1.88 KB

Contributing Guide

You will need:

Getting started

  1. Fork the project
  2. Clone your forked project by running git clone git@github.com:{ YOUR_USERNAME }/shepherd.git
  3. Run pnpm i to install node modules
  4. Test that you can build the source by running pnpm build and ensure the dist directory appears.

Writing code!

We use rollup to facilitate things like transpilation, minification, etc. so you can focus on writing relevant code. If there is a fix or feature you would like to contribute, we ask that you take the following steps:

  1. Most of the editable code lives in the src directory while built code will end up in the dist directory upon running pnpm build.

  2. The demo app is served out of the landing directory. Running pnpm start will open it in your browser and initiate a live-reloading session as you make changes.

Opening Pull Requests

  1. Please Provide a thoughtful commit message and push your changes to your fork using git push origin main (assuming your forked project is using origin for the remote name and you are on the main branch).

  2. Open a Pull Request on GitHub with a description of your changes.

Testing

All PRs that change code functionality are required to have accompanying tests.

Acceptance Tests

Acceptance tests are run using cypress. A number of different testing configurations can be found in package.json, but you can simply run pnpm test:cy:watch to build your latest changes and begin running the tests inside a Chrome browser instance.

⚠️ The acceptance tests are set up to run on localhost port 9002. If you'd like to change this port, make sure to change the baseUrl option inside of cypress.json, and change any references to port 9002 in package.json accordingly.