Architecture
A visual orientation to the contract, followed by the complete consumer guide and public reference.
Architecture
Atom UI is a headless React primitive package.
It provides:
- semantic element choices
- WAI-ARIA wiring
- keyboard and focus behavior
- controlled and uncontrolled state
- compound component context
- portals and positioning primitives
- small utilities needed by headless components
It does not provide:
- CSS
- design tokens
- icons
- visual variants
- router bindings
- product data models
Package Boundary
The package should be usable as a standalone dependency with React and React DOM as peer dependencies. Runtime dependencies stay intentionally narrow.
API Shape
The public API is namespace-first:
tsx
Subpaths are supported:
tsx
Direct part exports are also available for advanced composition and migration.