Skip to content

chore: add Cloud-specific dev environment setup #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
yuler wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

chore: add Cloud-specific dev environment setup #17

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot Mar 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To make this instruction more robust and prevent it from becoming outdated if .nvmrc is updated, you can use nvm use without specifying the version number. It will automatically pick up the version from the .nvmrc file.

Suggested change
- **Node.js**: `.nvmrc` specifies `v24`. Use `source ~/.nvm/nvm.sh && nvm use 24` before running any commands.
- **Node.js**: `.nvmrc` specifies `v24`. Use `source ~/.nvm/nvm.sh && nvm use` 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`.
3 changes: 3 additions & 0 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,5 +39,8 @@
"playwright": "^1.58.2",
"sharp": "^0.34.5",
"tsx": "^4.21.0"
},
"pnpm": {
"onlyBuiltDependencies": ["sharp", "esbuild"]
}
}
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot Mar 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It's a good practice to end files with a newline character. This aligns with POSIX standards for text files and can prevent potential issues with some command-line tools that process text files.

Suggested change
}
}

Loading