ui-kit/CONTRIBUTING.md

Contributing

Adding a component

1. Create it in src/components/ (primitive), src/animated/, or src/blocks/.
2. Use cn() + class-variance-authority for variants. Wrap Radix for interactive primitives.
3. Follow DESIGN.md: tinted neutrals, layered shadows, ease-out motion, focus-visible rings, no nested cards.
4. Export it from src/index.ts.
5. Add the component and its important states to showcase/showcase.tsx.
6. Add an interaction/accessibility test when behavior changes.
7. npm run check must pass.

Releasing

npm version <patch|minor|major> then npm publish (builds automatically). Tag notes in the commit. Consuming apps bump at their own pace.

Design guardrail

Every visual change should survive impeccable audit/polish and the living showcase in both themes. If the detector flags something intentional (e.g. a brand font), add a scoped ignore in .impeccable/config.json with a reason — don't disable the rule globally.