TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

Nextjs-Themes Version codecov Downloads npm bundle size Publish to npm and GitHub

🤟 👉 Unleash the Power of React Server Components

This project is inspired by next-themes. Next-themes is an awesome package, however, it requires wrapping everything in a provider. The provider has to be a client component as it uses hooks. And thus, it takes away all the benefits of Server Components.

nextjs-themes-lite removes this limitation and enables you to unleash the full power of React 18 Server Components. In addition, more features are coming up soon... Stay tuned!

  • ✅ Fully Treeshakable (import from nextjs-themes-lite/client/component)
  • ✅ Designed for excellence
  • ✅ Full TypeScript Support
  • ✅ Unleash the full power of React18 Server components
  • ✅ Works with all build systems/tools/frameworks for React18
  • ✅ Perfect dark mode in 2 lines of code
  • ✅ System setting with prefers-color-scheme
  • ✅ Themed browser UI with color-scheme
  • ✅ Support for Next.js 13 appDir
  • ✅ Sync theme across tabs and windows
  • ✅ Disable flashing when changing themes
  • ✅ Force pages to specific themes
  • ✅ Class or data attribute selector
  • ✅ Manipulate theme via useTheme hook

Check out the live example.


$ pnpm add nextjs-themes-lite
# or
$ npm install nextjs-themes-lite
# or
$ yarn add nextjs-themes-lite

Want Lite Version? npm bundle size

$ pnpm add nextjs-themes-lite-lite
# or
$ npm install nextjs-themes-lite-lite
# or
$ yarn add nextjs-themes-lite-lite

You need Zustand as a peer-dependency


With pages/

The best way is to add a Custom App to use by modifying _app as follows:

Adding dark mode support takes 2 lines of code:

import { ThemeSwitcher } from "next-themes";

function MyApp({ Component, pageProps }) {
  return (
      <ThemeSwitcher forcedTheme={Component.theme} />
      <Component {...pageProps} />

export default MyApp;

⚡🎉Boom! Just a couple of lines and your dark mode is ready!

Check out examples for advanced usage.

With app/

Update your app/layout.jsx to add ThemeSwitcher and SSCWrapper from nextjs-themes-lite. SSCWrapper is required to avoid flash of un-themed content on reload.

// app/layout.jsx
import { ThemeSwitcher } from "next-themes";
import { SSCWrapper } from "next-themes/server/nextjs";

export default function Layout({ children }) {
  return (
    <SSCWrapper tag="html" lang="en">
      <head />
        <ThemeSwitcher />

Woohoo! You just added dark mode and you can also use Server Component! Isn't that awesome!


That's it, your Next.js app fully supports dark mode, including System preference with prefers-color-scheme. The theme is also immediately synced between tabs. By default, next-themes modifies the data-theme attribute on the html element, which you can easily use to style your app:

:root {
  /* Your default theme */
  --background: white;
  --foreground: black;

[data-theme="dark"] {
  --background: black;
  --foreground: white;


In case your components need to know the current theme and be able to change it. The useTheme hook provides theme information:

import { useTheme } from "nextjs-themes-lite";

const ThemeChanger = () => {
  /* you can also improve performance by using selectors
   * const [theme, setTheme] = useTheme(state => [state.theme, state.setTheme]);
  const { theme, setTheme } = useTheme();

  return (
      The current theme is: {theme}
      <button onClick={() => setTheme("light")}>Light Mode</button>
      <button onClick={() => setTheme("dark")}>Dark Mode</button>

Force per page theme and color-scheme

Next.js app router

import { ForceTheme } from "nextjs-themes-lite";

function MyPage() {
  return (
      <ForceTheme theme={"my-theme"} />

export default MyPage;

Next.js pages router

For pages router, you have 2 options. One is the same as the app router and the other option which is compatible with next-themes is to add theme to your page component as follows.

function MyPage() {
  return <>...</>;

MyPage.theme = "my-theme";

export default MyPage;

In a similar way, you can also force color scheme.

Forcing color scheme will apply your defaultDark or defaultLight theme, configurable via hooks.

Migrating from v0 to v1

  • defaultDarkTheme is renamed to darkTheme
  • setDefaultDarkTheme is renamed to setDarkTheme
  • defaultLightTheme is renamed to lightTheme
  • setDefaultLightTheme is renamed to setLightTheme

Full docs coming soon!


Licensed as MIT open source.

Note: This package uses cookies to sync theme with server components

with 💖 by Mayank Kumar Chaudhari

Package Sidebar


npm i nextjs-themes-lite

Weekly Downloads






Unpacked Size

53.4 kB

Total Files


Last publish


  • mayank1513