# @tarsis/toolkit

React 19 component toolkit built with TypeScript, Vite, Storybook, and Vitest.

## Where Things Live

- `src/components/` - component categories and component folders.
- `src/components/primitives/` - shared low-level primitives.
- `src/hooks/`, `src/utils/`, `src/tokens.ts`, `src/styles/` - shared library code.
- `.storybook/` - Storybook workbench configuration.
- `.cursor/rules/` - design, animation, accessibility, layout, and React guidance.
- `.codex/skills/toolkit-component-author/` - project-local Codex skill for component work.
- `docs/backlog.md` - lightweight design and product notes that are not generated.
- `src/docs/README.md` - component documentation format.
- `COMPONENTS.md` - generated component catalog.

## Commands

```bash
yarn dev
yarn lint
yarn typecheck
yarn test
yarn build
yarn docs
yarn docs:validate
```

For agents, start with `AGENTS.md`.