# 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

```bash
npm install
npm run storybook    # Component development at localhost:6006
npm run dev          # Vite dev server
```

## Architecture

- **Tokens** — Design tokens in `src/tokens/tokens.css` as a Tailwind v4 `@theme` block
- **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 |