# UI Atlas

> A deterministic registry of 306 UI components, 20 screen recipes, seven implementation targets, and 35 quality rules for human designers and AI clients.

UI Atlas distinguishes formal names, official variants, common aliases, and non-equivalent related UI patterns. Its search is deterministic term search with match reasons; it does not interpret free-form prose. An AI client must normalize prose requirements into the documented structured request before asking UI Atlas to recommend a screen.

Never invent a component ID. Keep unresolved product decisions explicit. Generated audit results do not replace product-specific runtime, assistive-technology, real-device, or end-to-end testing.

## Core resources

- [Machine-readable registry](https://ui-atlas.pages.dev/registry/ui-atlas.registry.json): Complete components, names, contracts, recipes, tokens, targets, and quality rules.
- [API discovery index](https://ui-atlas.pages.dev/api/index.json): Resource URLs, responsibility boundary, and CLI/MCP interface metadata.
- [AI design-engine contract](https://ui-atlas.pages.dev/docs/AI-DESIGN-ENGINE.md): Structured input, screen-plan output, state, responsive, and audit contracts.
- [UI Atlas Skill](https://ui-atlas.pages.dev/skill/ui-atlas/SKILL.md): Workflow for external AI agents.
- [Human catalog](https://ui-atlas.pages.dev/): Search, compare, inspect, and copy implementations.

## Interfaces

- [Search engine](https://ui-atlas.pages.dev/shared/search-engine.js): The same deterministic browser/CommonJS ranking implementation used by the site and package.
- [Package README](https://ui-atlas.pages.dev/README.md): CLI, Node.js API, MCP, Skill installation, and local-site usage.

## Optional

- [Component export index](https://ui-atlas.pages.dev/components/index.json): Paths to generated artifacts for all components.
- [Figma plugin guide](https://ui-atlas.pages.dev/figma-plugin/README.md): Local Figma component import workflow.