# Snurble design system

Snurble packages the shared design-system contract extracted from workv2 into design tokens and Astro primitives. The docs site now leads with a foundation guide, a component-by-component reference, the LLM helper API, and the release guides that support safe adoption.

## Start here

- Foundation guide: token-layer guidance for density, focus mode, and layered shadow depth lives on /foundation.
- Components: every shared Astro primitive has its own docs route under /components.
- LLM helper API: markdown-alternate helper guidance lives on /llm-helper.
- Adoption path: the migration and release-readiness guides explain how consumers adopt published packages safely.

## Current package surface

The shared package surface currently includes:

- 1 token foundation guide route under /foundation
- 78 Astro runtime primitives under /components
- 1 LLM helper API route under /llm-helper
- markdown twins for the docs front door, top-level guides, and every component page

## Recommended reading order

1. Foundation guide
2. Components index
3. Individual component docs
4. LLM helper API
5. Adoption and release guides