Troubleshooting Guide
Common issues and fixes encountered during development and build processes.
1. Build Error: "minify" is not allowed
Error Message:
❌ Error generating Critical CSS: [ConfigError: ConfigError: "minify" is not allowed]Cause:
The critical NPM package (v7+) removed the minify configuration option. The build script scripts/generate-critical.mjs was attempting to pass this invalid option to the generator.
Solution:
Remove the minify: true line from scripts/generate-critical.mjs.
2. Warning: Browserslist is outdated
Warning Message:
Browserslist: caniuse-lite is outdated. Please run:
npx update-browserslist-db@latestCause: The database used by Autoprefixer and Tailwind to determine browser support is older than the installed package expects.
Solution: Run the command suggested in the warning to update the local database:
npx update-browserslist-db@latest