Richie 1c87e23e5d Add library entry point and package exports for consumption
Add src/index.ts barrel export re-exporting all components, types, and
utilities. Configure package.json with main, exports (root, tokens,
utils), peerDependencies for react/react-dom, and bump to 0.1.0.
Consumers can now install via local path and import directly:

  import { Button, AppShell, cn } from 'ads3-design-system'
  import 'ads3-design-system/tokens'

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-03 16:02:44 +10:00

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.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
Description
No description provided
Readme 817 KiB
Languages
TypeScript 96.9%
CSS 2.7%
JavaScript 0.3%
HTML 0.1%