Skip to content

Add dev environment setup: fix broken dependency, configure build scripts, add AGENTS.md#2

Draft
jotalis wants to merge 1 commit intomainfrom
cursor/dev-env-setup-42df
Draft

Add dev environment setup: fix broken dependency, configure build scripts, add AGENTS.md#2
jotalis wants to merge 1 commit intomainfrom
cursor/dev-env-setup-42df

Conversation

@jotalis
Copy link
Copy Markdown
Collaborator

@jotalis jotalis commented Apr 15, 2026

Summary

Sets up the development environment for the ICSSC website by fixing a broken transitive dependency and configuring pnpm build scripts.

Changes

  • Fix broken @opennextjs/aws dependency: The original pnpm-lock.yaml referenced a stale pkg.pr.new URL that returns 404. Added pnpm.overrides to pin @opennextjs/aws to 3.4.2 so pnpm install succeeds.
  • Allow required build scripts: Added pnpm.onlyBuiltDependencies to allowlist @biomejs/biome, esbuild, sharp, and workerd so their postinstall scripts run (required for linting and builds).
  • Regenerated pnpm-lock.yaml with working dependency URLs.
  • Added AGENTS.md with Cursor Cloud development instructions and gotchas.

Verification

All core development workflows verified:

Check Command Result
Install pnpm install Passes
Lint pnpm lint Passes (pre-existing warnings only)
Build pnpm build Passes (14/14 static pages)
Dev server pnpm dev Serves on port 3000

icssc_website_demo.mp4

Site running locally — navigated through Landing, About, Events, and Projects pages.

Landing page
Projects page

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

…GENTS.md

- Add pnpm.overrides to pin @opennextjs/aws to 3.4.2 (fixes stale pkg.pr.new 404)
- Add pnpm.onlyBuiltDependencies for biome, esbuild, sharp, workerd
- Regenerate pnpm-lock.yaml with working dependency URLs
- Add AGENTS.md with Cursor Cloud development instructions

Co-authored-by: Jay Wu <jotalis@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants