Roadmap
Theme Kit
Where Theme Kit is heading — themes, adapters, tooling, and the community surface. Checked items are shipped in the current release.
12026 — Q3 (current)
16 of 16 completed
- **Framework picker pass** — a single top-of-page framework selector drives every code snippet on `/custom-themes`, `/scoped-theme`, `/sunrise-sunset`, `/animation`, and `/custom-scrollbar`.
- **Sunrise/sunset scheduling in every framework** — `useThemeSchedule()` / `getThemeSchedule()` / `injectThemeSchedule()` exposed across React, Next, Vue, Nuxt, Svelte, Solid, Angular, Remix, Astro, and Web Components.
- **Custom scrollbar overlay engine** — theme-aware overlay with native physics, arrows, auto-hide, and pre-paint CSS; shipped as `@theme-kit/core` + wrappers for every framework.
- **Nuxt Tier-1 SSR-first integration** — SSR theme resolution, cookie + localStorage sync, zero-flash bootstrap, config-driven transitions and scrollbar (`@theme-kit/nuxt`).
- **Playground** — live theme switcher, interactive token tree, history / time-travel timeline, solar schedule demo, and scrollbar lab.
- **Theme Studio** — generate a light/dark pair from a seed color and apply it to the runtime (`/theme-studio`).
- **Accessibility lab** — live WCAG contrast checks and CVD simulations (`/accessibility`).
- **Multi-window sync** — cross-tab theming over BroadcastChannel / SharedWorker / StorageEvent, documented on `/multi-window-sync`.
- **Individual package pages** — deep-dive pages per package with install tabs and API tables (`/packages/{slug}`).
- **Site search** — full-text search over all content (⌘K).
- **API Reference generation** — `/api-reference/{package}` generated from `packages/*/src` with typedoc (signatures, parameters and types can't drift); regenerate via `pnpm --filter @theme-kit/docs api:generate`.
- **Docs/API parity audit** — every documented API verified against the real package exports; deprecated snippets corrected.
- **Blog** — markdown-driven publishing for release notes and deep dives (`/blog`).
- **Showcase page** — gallery of official tools and framework example apps (`/showcase`).
- **Styled 404 page** matching the design system.
- **Mobile docs navigation** — animated mobile menu + drawer for the docs sidebar.
22026 — Q3 (next)
0 of 3 completed
- **Interactive token diffing** — compare two themes side by side in the Playground.
- **Playground live runtime preview** — a `runtime.update()` sandbox showing token edits re-theme a real component tree.
- **Theme inheritance visualizer** — animate `extends` chains and token overrides in Core Concepts.
32026 — Q4
0 of 4 completed
- **Version-pinned API reference** — version badges and deprecation / breaking-change notes per API.
- **Changelog / migration guides** — surface `migrate-theme` and the versioning story on the site.
- **Page transitions** — smooth route transitions using Theme Kit's View Transitions support.
- **Analytics** — lightweight, privacy-friendly analytics to guide documentation priorities.
42027 — H1
0 of 4 completed
- **Interactive diagrams** — animated mode + family + token diagrams in Core Concepts.
- **Plugins / lifecycle lab** — interactive plugin playground with lifecycle event logging.
- **Automated a11y conformance** — run axe / WCAG audits across every route in CI.
- **Link checker + CI** — lint, typecheck, build and link-check all routes on every PR.
5Guiding Principles
The entire documentation website is built using Theme Kit itself. Every theme change on the website is powered by Theme Kit's runtime. Every example shown in the docs is executed using Theme Kit — not mocked or simulated. Whenever a new feature is added to Theme Kit, the documentation adopts that feature internally wherever appropriate. **Theme Kit powers Theme Kit.**