docs: update deployment checklist in .cursorrules
- Remove --env flag usage from deployment checklist - Add explicit note: Do NOT use --env flags - Remove 'Multiple environments warning' troubleshooting (no longer applicable) - Keep all other important deployment steps and troubleshooting
This commit is contained in:
parent
c2185713a6
commit
a60cb56ffc
23
.cursorrules
23
.cursorrules
@ -328,6 +328,29 @@ npx wrangler deploy
|
||||
|
||||
**Important:** Always use `npx wrangler deploy` without any `--env` flags. The deployment uses the default configuration from `wrangler.jsonc` with route `agents.nicholai.work`. Update `wrangler.jsonc` with new env vars in the top-level `vars` section.
|
||||
|
||||
### Deployment Checklist (must be followed exactly):
|
||||
|
||||
1. **Never use npm.** Always run commands with pnpm (e.g. `pnpm install`, `pnpm dev`, `pnpm build`).
|
||||
|
||||
2. **Before every deploy, run the Cloudflare build step:**
|
||||
```bash
|
||||
npx @opennextjs/cloudflare build
|
||||
```
|
||||
If this fails, fix the error before proceeding—Wrangler deploys without this step will push stale assets.
|
||||
|
||||
3. **Deploy only after a successful OpenNext build using:**
|
||||
```bash
|
||||
npx wrangler deploy
|
||||
```
|
||||
**Do NOT use `--env` flags.** The deployment uses the default configuration from `wrangler.jsonc`.
|
||||
|
||||
**Troubleshooting:**
|
||||
- "No updated asset files to upload": you skipped the Cloudflare build; rerun step 2.
|
||||
- ESLint config errors during build: they're informational—build still succeeds, but you should address them separately.
|
||||
- Viewport metadata warning: move viewport values from metadata to generateViewport per Next.js docs.
|
||||
|
||||
**No deploy is compliant unless each step above is completed and verified.**
|
||||
|
||||
## Debugging Tips
|
||||
|
||||
### Check Agent Configuration
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user