feat: initial @jason/ui-kit — tokens, preset, components, motion, blocks, Impeccable

2026-07-16 00:36:53 -05:00
commit b75012525d
36 changed files with 1324 additions and 0 deletions
@@ -0,0 +1,17 @@
+# 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. `npm run typecheck && npm run build && npm run design:detect` 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`. 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.