# Troubleshooting Guide

Common issues and fixes encountered during development and build processes.

## 1. Build Error: "minify" is not allowed

**Error Message:**
```text
❌ 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:**
```text
Browserslist: caniuse-lite is outdated. Please run:
npx update-browserslist-db@latest
```

**Cause:**
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:
```bash
npx update-browserslist-db@latest
```