# Acme Design System

> React components, semantic design tokens and usage rules for Acme web products. Package: `@acme/ui` 4.x.

Important notes:

- Import components only from `@acme/ui`.
- `@acme/ui` does not export `PrimaryButton`, `IconButton`, `LinkButton` or `Toggle`. Each page lists what does not exist.
- Style with semantic tokens only.

## Components

- [Button](https://design.acme.example/components/button.md): Triggers one action in the current view
- [Link](https://design.acme.example/components/link.md): Navigates to another page or place
- [Switch](https://design.acme.example/components/switch.md): A setting that takes effect immediately

## Machine-readable

- [Component contracts](https://design.acme.example/contracts/index.json): One contract per component (Field Guide 02)
- [Design tokens](https://design.acme.example/tokens/tokens.resolver.json): DTCG 2025.10 (Field Guide 03)
