Describe the bug
Themes are getting reset on reload

To Reproduce
Steps to reproduce the behavior:

1. Deploy the site
2. Change the default dark and light themes
3. Set colorScheme to system
4. Reload the page

Expected behavior
On reload same themes should be there

Additional context
Seems like the error is because of conflict between persist middleware and shared.

Describe the bug
There is a flash on reloading page when using next.js app directory.

To Reproduce
Steps to reproduce the behavior:

1. Run advanced-multi-theme example
2. Change theme
3. Reload page
   → White screen flashes before theme is applied.

Expected behavior
There should be no flash of un- themed styles

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

Doc comments are used by modern IDEs to show tooltips. This is very helpful while using the library. It also improves auto-generated documentation.

How to contribute

You can create separate issues for each component or groups of components for which you want to provide the jsdoc comments. Then fork the repo → add appropriate comments and finally create PR targeting the main branch of this repo.

For inspiration, please look at https://github.com/react18-tools/nextjs-themes-ultra.

Upvote & Fund

• We're using Polar.sh so you can upvote and help fund this issue.
• We receive the funding once the issue is completed & confirmed by you.
• Thank you in advance for helping prioritize & fund our backlog.

Add example for pages router, showing different ways this package can be used with pages directory.

Theme switching does not work when components are imported from their respective files, e.g., "nextjs-themes/client/theme-switcher".