Common Issues
ui
Dark Mode Not Working Properly
Your app has a dark mode but it doesn't work correctly. Text becomes invisible against the background, some components stay light while others go dark, the toggle doesn't persist across pages, or the initial flash of the wrong theme is jarring.
Common Causes
- Some components have hardcoded colors instead of using theme variables
- Theme preference not saved to localStorage — resets on page reload
- CSS variables defined for light mode but not for dark mode
- Third-party components don't respect the app's theme
- Flash of unstyled content (FOUC) before the theme loads
How to Fix It
- Toggle dark mode and inspect elements that look wrong — check if they use theme variables or hardcoded colors
- Verify the theme toggle saves the preference to localStorage
- Check that all CSS variables have both light and dark mode values
- Test every page in dark mode — AI tools often miss some pages
- Add a script in the HTML head to apply the theme before the page renders (prevents FOUC)
Real developers can help you.
Describe what's wrong in plain English. No technical knowledge needed.
Get HelpFrequently Asked Questions
Some pages are dark but others aren't. Why?
AI tools often implement dark mode incrementally and miss some pages or components. A developer can audit the entire app and make dark mode consistent.
The app flashes white before going dark. Can this be fixed?
Yes. This is called Flash of Unstyled Content (FOUC). It's fixed by loading the theme preference before the CSS renders, usually with a small script in the HTML head.