@wrksz/themes

Drop-in replacement for next-themes. React 19 hydration fixed, full TypeScript types, zero dependencies.

$add @wrksz/themes

Features

React 19 ready
Fixes the inline script warning, Activity/cacheComponents stale theme, and the __name minification bug.
Drop-in replacement
Same API as next-themes. Change one import.
Hybrid storage
Use storage="hybrid" for cookie-first SSR correctness plus cross-tab sync via localStorage.
Nested providers
Independent theme instances per section. No shared state between them.
Full type safety
createThemes(...) infers your theme union once and types useTheme, useThemeValue, and setTheme everywhere.
Zero runtime deps
No runtime dependencies. A tiny inline script plus React hooks, nothing more.

Set up themes in your project

A ready prompt that points your agent at the agent guide. Paste it into Claude Code, Codex or any agent working in your repository.

Coming from next-themes? The migration guide has a prompt for that.

next-themes still has React 19 bugs open.

React 19 script warningFixed (useServerInsertedHTML)Fixed

__name minification bugFixedFixed

React 19 Activity / cacheComponents stale themeFixed (useSyncExternalStore)Fixed

Multiple classes per themeFixed (correct class removal)Fixed

Nested providersper-instance storeYes

sessionStorage supportYesYes

cookie storage (zero-flash SSR)storage="cookie"Yes

Disable storagestorage="none"Yes

meta theme-color supportthemeColor propYes

Server-provided themeinitialTheme propYes

Always follow system preferencefollowSystem propYes

disableTransitionOnChange per propertyCSS string + inline scriptYes

Read theme outside ReactgetTheme()Yes

Generic typesuseTheme<AppTheme>()Yes

Zero runtime dependenciesYesYes

Feature	next-themes	@wrksz/themes
React 19 script warning	Bug	Fixed (useServerInsertedHTML)Fixed
__name minification bug	Bug	FixedFixed
React 19 Activity / cacheComponents stale theme	Bug	Fixed (useSyncExternalStore)Fixed
Multiple classes per theme	Bug	Fixed (correct class removal)Fixed
Nested providers	No	per-instance storeYes
sessionStorage support	No	YesYes
cookie storage (zero-flash SSR)	No	storage="cookie"Yes
Disable storage	No	storage="none"Yes
meta theme-color support	No	themeColor propYes
Server-provided theme	No	initialTheme propYes
Always follow system preference	No	followSystem propYes
disableTransitionOnChange per property	No	CSS string + inline scriptYes
Read theme outside React	No	getTheme()Yes
Generic types	No	useTheme<AppTheme>()Yes
Zero runtime dependencies	YesYes	YesYes

Framework agnostic
Remix, Vite, SvelteKit, and other React-based frameworks.
More features
More storage adapters and finer-grained resolution options.
Open to contributions
Bug reports, feature requests, and PRs are welcome on GitHub.

Jakub@jakubwarkuszFull-Stack DeveloperGdańsk17 followers230 changes in total, first in v0.1.0
Martijn van Dijk@martijn00@microsoft MVP, @Google Flutter Insider, creator of many open source packages.The Netherlands816 followers68 changes in total, first in v1.1.0
Oliwier Perzyński@oliverperzykFull-Stack DeveloperGdańsk, Poland22 followers3 changes in total, first in v0.9.1
Sebastian Sala@salasebas4 followers1 change in total, first in v0.9.1
pttydou@pttydou4 followers1 change in total, first in v2.0.0