Richie
69751eb6f2
Add a separate Vite library build (vite.lib.config.ts + `build:lib`) that bundles src/index.ts to ESM with React/react-dom externalised and the 97 internal `@/` imports resolved at build time, plus type declarations and copies of tokens.css / typography.css into dist. Point package.json exports/main/types at dist and make react a peer dependency, so ADS can be consumed as an installed package (@geljic/ads3-design-system) rather than a file: + `@/` alias dependency. Co-Authored-By: Claude Opus 4.8 (1M context) <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 |