Package decision guide
Which package should I install?
Start from what you're building. Every framework package pulls the core runtime, so you install the integration, not everything at once.
Pick your entry point
You need the runtime
@theme-kit/core →
The framework-agnostic heart — store, registry, runtime, transitions, persistence, adapters.
You're using React
@theme-kit/react →
Provider, hooks and ThemeScope. The base that Next and Remix re-export.
You're using Next.js
@theme-kit/next →
App Router SSR: cookie persistence, zero-flash bootstrap, blocking script.
You're using Vue 3
@theme-kit/vue →
Provider component, composables and scoped theming.
You're using Nuxt 3
@theme-kit/nuxt →
A Nuxt module — configure in nuxt.config.ts, composables auto-import.
You're using Svelte 5
@theme-kit/svelte →
Context-based provider with reactive readable stores.
You're using Solid
@theme-kit/solid →
Signals-first provider, getters and scoped subtrees.
You're using Angular
@theme-kit/angular →
DI providers, reactive injectables and an element-scoped directive.
You're using Astro
@theme-kit/astro →
Islands-friendly with a shared global runtime and zero-flash bootstrap.
You're using Remix
@theme-kit/remix →
Loader-based SSR theming with a blocking head script.
No framework, or Web Components
@theme-kit/web →
Custom elements and imperative APIs for any HTML page.
You use Tailwind CSS v4
@theme-kit/tailwind →
Maps semantic tokens to @theme variables and utilities.
Common combinations
Next.js + MUI
@theme-kit/core@theme-kit/next@theme-kit/mui
Next.js + shadcn/ui
@theme-kit/core@theme-kit/next@theme-kit/shadcn
React + Chakra UI
@theme-kit/core@theme-kit/react@theme-kit/chakra
Vue + Bootstrap
@theme-kit/core@theme-kit/vue@theme-kit/bootstrap
Nuxt + daisyUI
@theme-kit/core@theme-kit/nuxt@theme-kit/daisyui
React + Mantine
@theme-kit/core@theme-kit/react@theme-kit/mantine
For example — Next.js with Material UI:
npm install @theme-kit/core @theme-kit/next @theme-kit/mui