# @codenhub/theme

> Zero-dependency browser theme preference, persistence, DOM, cross-tab, event,
> and token manager with SSR-safe fallbacks.

Call `init()` in the browser, keep pre-paint logic aligned with configuration,
and call `destroy()` to release media-query/storage listeners and subscribers.

## Documentation

- [Documentation overview](docs/index.md): Purpose, status, and starting points.
- [Tokens, persistence, and cross-tab sync](docs/tokens-and-persistence.md): Token
  resolution priority, `localStorage` persistence, and cross-tab sync.
- [SSR, pre-paint, and Tailwind](docs/ssr-and-pre-paint.md): FOUC prevention, SSR
  fallbacks, and Tailwind `dark` class toggling.

## Optional

- [API reference](docs/reference/index.md): Generated per-symbol signatures and prose.
