Navigated to /docs/ui-core

UI Core overview

Resolve Tavo.js theme configuration and tokens in platform-neutral tooling without importing a web or native renderer.

Use UI Core only at a tooling boundary

@tavojs/ui-core validates theme configuration and returns color ramps, semantic modes, static tokens, resolved breakpoints, and accessibility warnings as plain data. It has no DOM, component renderer, Tavo.js runtime, Vite, or CSS module dependency.

Understand the resolution pipeline

  • Apply the selected preset and merge explicit project values over it.

  • Resolve breakpoints, then validate the config shape and supported values.

  • Resolve viewport and breakpoint values.

  • Generate light and dark color modes plus mode-independent tokens.

  • Collect contrast warnings or fail when configured to enforce them.

The result contains plain records, so the consuming platform decides whether to emit CSS variables, native objects, JSON, or design-tool data.

Choose a UI Core guide