# Contributing

1. Open an issue describing the proposed change (token, component, doc).
2. Branch from `main`: `git checkout -b feat/<short-name>`.
3. Update `design.md` first — it is the source of truth.
4. Regenerate `tokens/` exports.
5. Add or update component documentation under `components/<name>/`.
6. Open a PR; the design-system maintainers (see `CODEOWNERS`) will review.

## PR checklist

- [ ] `design.md` updated
- [ ] Tokens regenerated
- [ ] Component spec updated (states + a11y)
- [ ] Changelog entry added under `[Unreleased]`
- [ ] Visual examples attached