@assure-one/design-system 0.1.1

package/README.md

@@ -0,0 +1,64 @@
+# Assure One Design System
+
+The single source of truth for visual design across all Assure One products.
+
+- **Tokens** — semantic CSS variables (color, type, spacing, motion) consumed by every product.
+- **Primitives** — accessible React components built on Radix + Tailwind 4.
+- **Patterns** — common compositions (DataTable, FormField, EmptyState).
+
+## Install
+
+```bash
+pnpm add @assure-one/design-system
+```
+
+Import tokens once in your root layout:
+
+```ts
+import "@assure-one/design-system/styles.css";
+```
+
+Then use components:
+
+```tsx
+import { Button } from "@assure-one/design-system";
+
+export default function Page() {
+  return <Button variant="primary">Click me</Button>;
+}
+```
+
+## Develop
+
+```bash
+pnpm install
+pnpm storybook    # http://localhost:6006
+pnpm build        # bundle for publishing
+pnpm typecheck
+pnpm lint
+```
+
+## Architecture
+
+3-tier token system (W3C Design Tokens spec compatible):
+
+```
+reference   →   system (semantic)   →   component
+color.navy.700  →  color.action.primary.bg  →  button.primary.bg
+```
+
+Components consume **system tokens**, never reference values directly. Themes (light, dark, per-product accent) re-map system → reference without touching component code.
+
+## Release
+
+We use [Changesets](https://github.com/changesets/changesets). Every PR with a user-visible change includes a changeset:
+
+```bash
+pnpm changeset
+```
+
+Merging to `main` triggers a "Version Packages" PR. Merging that PR publishes to GitHub Packages.
+
+## Status
+
+Pre-release. Not yet published. APIs may change.