Fix Corrupted Panda CSS (styled-system)
This project uses Panda CSS which generates a styled-system/ directory. This directory can become corrupted when:
- •Prettier or other formatters modify the generated files
- •Git merge conflicts in styled-system/
- •Interrupted
panda codegenruns - •Node modules corruption
Symptoms
- •Styles not applying correctly
- •CSS appears broken or missing
- •Build errors mentioning
styled-system - •Type errors in
styled-system/imports - •Visual regressions that appeared without code changes
Fix Procedure
Run these commands in order:
bash
# 1. Delete the corrupted styled-system rm -rf apps/web/styled-system # 2. Regenerate it with Panda CSS cd apps/web && pnpm panda codegen # 3. Clear Next.js cache (if build errors persist) rm -rf apps/web/.next # 4. Rebuild to verify cd /Users/antialias/projects/soroban-abacus-flashcards && pnpm build
Verification
After regeneration, verify:
- •
apps/web/styled-system/directory exists with fresh files - •
pnpm buildcompletes without styled-system errors - •Dev server shows correct styling
Prevention
The repo has .prettierignore at the root that excludes **/styled-system/**. If corruption keeps happening:
- •Verify
.prettierignorecontains**/styled-system/** - •Check that IDE formatters respect
.prettierignore - •Ensure git hooks don't format styled-system files
Quick One-Liner
For fast fix without explanation:
bash
rm -rf apps/web/styled-system apps/web/.next && cd apps/web && pnpm panda codegen && cd ../.. && pnpm build