Skip to content

Resources

Contributing

How to contribute to Stance: development setup, adding a component with tests and docs, the checks every pull request passes, and changesets.

Development setup

bash
git clone https://github.com/BindsHQ/stance.git
cd stance
npm install
npm run build
npm test
npm run dev:docs   # http://localhost:3100

Adding a component

  1. Check that the need appears in at least one product and isn’t covered by composing existing parts.
  2. Create packages/react/src/components/<name>/ with the component, CSS, tests and index.ts.
  3. Use only --st-* tokens in CSS, and test keyboard behaviour and axe in all three themes.
  4. Add apps/docs/content/components/<name>.tsx with examples and the full API.
  5. Run npx changeset to describe the change for the release notes.

Read CONTRIBUTING.md for the full guide and code of conduct.