Richie
95f72407f8
Introduce AppShell, DashboardPage, ListPage, and FormPage template components with Storybook recipe stories for AI agent consumption. Thoroughly update DESIGN.md with all missing components, corrected token values, and page layout conventions. Fix SideNav button items defaulting to centered text. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
ADS 3.0 Design System
A React component library implementing the ADS 3.0 (Adaptive Design System) design language. Built with React 19, TypeScript, Tailwind CSS v4, and Storybook 10.
Getting Started
npm install
npm run storybook # Component development at localhost:6006
npm run dev # Vite dev server
Architecture
- Tokens — Design tokens in
src/tokens/tokens.cssas a Tailwind v4@themeblock - Atoms — Single-purpose elements (Button, Input, Badge, etc.)
- Molecules — Small compositions (Alert, Dialog, Card, Accordion)
- Organisms — Page-level regions (AppShell, TabBar)
Usage as a Base
This repo is designed to be forked for specific applications. Fork it, then build your application screens and domain logic on top of the shared component set.
Tech Stack
| Tool | Purpose |
|---|---|
| React 19 | UI framework |
| TypeScript (strict) | Type safety |
| Tailwind CSS v4 | Utility-first styling via CSS-first config |
| Storybook 10 | Component development and documentation |
| Vite | Build tooling |