From dd16946e6e36e4e4b58c38b8f3d767bcde372ecd Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 30 Mar 2026 15:17:29 +0000 Subject: [PATCH] chore: add Cloud-specific dev instructions and allow sharp/esbuild builds - Add Cursor Cloud specific instructions section to AGENTS.md with non-obvious dev environment caveats (Node v24, sharp build approval, no external services needed, no test framework) - Add pnpm.onlyBuiltDependencies to package.json to allow sharp and esbuild postinstall scripts to run non-interactively Co-authored-by: Yu Le --- AGENTS.md | 9 +++++++++ package.json | 3 +++ 2 files changed, 12 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 2ef2f1a..6958b9f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -18,3 +18,12 @@ Every icons should a simple astro component locate in [`src/components/icons`](. ## Git Commit Every commit needs to invoke the `/git-commit` skill. + +## Cursor Cloud specific instructions + +- **Node.js**: `.nvmrc` specifies `v24`. Use `source ~/.nvm/nvm.sh && nvm use 24` before running any commands. +- **sharp build approval**: `package.json` includes `pnpm.onlyBuiltDependencies` to allow `sharp` and `esbuild` postinstall scripts. Without this, `pnpm install` will warn about ignored build scripts and image optimization will fail. +- **Dev server**: `pnpm dev --host 0.0.0.0` starts Astro on port 4321. No external services (databases, APIs) are required for local development. +- **Lint/check**: `pnpm check` runs `astro check` (TypeScript diagnostics). There are no separate ESLint or Prettier configs. +- **Build**: `pnpm build` runs `astro check && astro build`. Output goes to `dist/`. +- **No automated test suite**: This project has no unit/integration test framework configured. Validation is done via `pnpm check` and `pnpm build`. diff --git a/package.json b/package.json index 4967042..da7f14c 100644 --- a/package.json +++ b/package.json @@ -39,5 +39,8 @@ "playwright": "^1.58.2", "sharp": "^0.34.5", "tsx": "^4.21.0" + }, + "pnpm": { + "onlyBuiltDependencies": ["sharp", "esbuild"] } } \ No newline at end of file