Drop-in replacement for next-themes

@wrksz/themes

Modern theme management for Next.js 16+ and React 19+. Fixes every known bug in next-themes and adds the features that were missing.

Everything next-themes should have been

Bug fixes and new features, zero API changes.

Fixes the inline script warning, Activity/cacheComponents stale theme, and the __name minification bug.

Same API as next-themes. Swap the import and you are done. No migration needed.

Independent theme instances per section. Each provider manages its own state with a per-instance store.

Generic useTheme<AppTheme>() constrains setTheme to your exact theme union. No casting needed.

localStorage, sessionStorage, or none. Disable persistence for forced or server-driven themes.

No runtime dependencies. Ships only what the browser needs: a tiny inline script and React hooks.

43 open issues, 16 open PRs, React 19 bugs unresolved.

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

Disable storagestorage="none"Yes

meta theme-color supportthemeColor propYes

Server-provided themeinitialTheme propYes

Generic typesuseTheme<AppTheme>()Yes

Zero runtime dependenciesYesYes

	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
Disable storage	No	storage="none"Yes
meta theme-color support	No	themeColor propYes
Server-provided theme	No	initialTheme propYes
Generic types	No	useTheme<AppTheme>()Yes
Zero runtime dependencies	YesYes	YesYes

The library is actively developed and growing.

Framework agnostic

Remix, Vite, SvelteKit, and any React-based framework. Not just Next.js.

More features

New APIs, more storage adapters, and deeper control over theme resolution.

Open to contributions

Bug reports, feature requests, and PRs are welcome on GitHub.