Roadmap
Themvora
Where Themvora is heading — themes, adapters, tooling, and the community surface. Checked items are shipped in the current release.
12026 — Q3 (current)
26 of 26 completed
- **Framework picker pass.** One selector at the top of a page drives every snippet below it, across `/custom-themes`, `/scoped-theme`, `/sunrise-sunset`, `/animation` and `/custom-scrollbar`. The picker leaves out Tailwind and UnoCSS, because they are CSS integrations with no provider to mount.
- **Scheduling in every framework.** `useThemeSchedule()`, `getThemeSchedule()` and `injectThemeSchedule()` exist for React, Next, Vue, Nuxt, Svelte, Solid, Angular, Remix, Astro and Web Components.
- **Custom scrollbar overlay.** Theme-aware overlay with native physics, arrows, auto-hide and pre-paint CSS. Ships in `@themvora/core` with a wrapper per framework.
- **Nuxt integration.** SSR theme resolution, cookie and localStorage sync, zero-flash bootstrap, config-driven transitions and scrollbar.
- **Playground.** Live theme switcher, interactive token tree, history and time-travel, solar schedule demo, scrollbar lab.
- **Theme Studio.** Generate a light/dark pair from a seed colour and apply it to the running site.
- **Accessibility Lab.** Live WCAG contrast checks, full-theme audits, CVD simulation.
- **Multi-window sync.** Cross-tab theming over BroadcastChannel, SharedWorker and StorageEvent.
- **Package pages.** A deep-dive page per package with install tabs and API tables.
- **Site search.** Full-text search over all content (⌘K).
- **API reference generation.** `/api-reference/{package}` is generated from `packages/*/src` with TypeDoc, so signatures cannot drift from the code.
- **Docs/API parity audit.** Every documented API is checked against the real package exports.
- **Blog.** Markdown-driven release notes and deep dives.
- **Recipes.** Nine task-oriented patterns at `/recipes`, each with a package-manager install command and prev/next navigation.
- **Showcase.** Seven themed interfaces you can filter and restyle live, plus the real surfaces Themvora runs on.
- **Styled 404 page** that matches the design system.
- **Mobile docs navigation.** Animated menu and drawer for the docs sidebar.
- **Package map.** `/package-map` — the four-layer architecture, the dependency graph, and a reference entry for all 24 packages. Generated from the manifests, so the dependencies cannot go stale.
- **Examples.** `/examples` — ten runnable starter apps (one per framework) and twenty-one focused concept examples, filterable by framework, concept, complexity and package. Each concept shows its real source file, read from `examples/` at build time.
- **Canonical URLs.** Every route declares its own. Previously all 66 routes claimed the homepage as canonical, which told search engines the entire site was a duplicate of `/`.
- **Sitemap and robots.** `/sitemap.xml` and `/robots.txt`, with a coverage check in `pnpm links` so a new page cannot silently go unlisted.
- **Open Graph images.** A shared renderer plus per-section cards for framework guides, library adapters, blog posts, Playground, Theme Studio and Accessibility Lab. Before this the site declared a large-image Twitter card with no image at all.
- **Accessibility pass.** Navigation landmarks, `aria-current` on every active nav link, accessible names on every control, and a real tablist for the package-manager selector.
- **CLI reference generated from source.** The CLI's own help text now drives the reference and every command page, so a new flag cannot be documented everywhere except the docs.
- **Snippet accuracy audit.** All 709 documentation snippets extracted and checked against the built packages; the invented CSS variable name it found was fixed in six places.
- **Internal style guide.** `docs/style-guide.md` — how the docs are written, kept internal rather than published as a route.
22026 — Q3 (next)
0 of 3 completed
- **Playground live runtime preview.** A `runtime.update()` sandbox where token edits re-theme a real component tree.
- **Theme inheritance visualizer.** Animate `extends` chains and token overrides in Core Concepts.
- **Per-API deprecation notes.** Version badges shipped; what is missing is the deprecation and breaking-change note attached to the specific API that changed.
32026 — Q4
0 of 3 completed
- **Page transitions.** Smooth route transitions using Themvora's View Transitions support. Theme transitions already use it; routes do not.
- **Interactive diagrams.** Animated mode, family and token diagrams in Core Concepts.
- **Plugins and lifecycle lab.** A plugin playground that logs lifecycle events as they fire.
42027 — H1
0 of 2 completed
- **Automated a11y conformance.** Run axe and WCAG audits across every route in CI. The current pass was manual, so it can regress.
- **Search that understands tokens.** Today search matches text; it should find `--theme-color-primary` when you type "primary colour".
5Guiding Principles
The documentation website is built with Themvora itself. Every theme change on this site goes through Themvora's runtime. Every example in the docs runs against the real packages — nothing is mocked or simulated. When a feature lands, the documentation adopts it internally wherever that makes sense. Themvora powers Themvora.