AGENTS.md

Greenfield: when you edit the page, expose the dev port so the user can collaborate on the design by opening the page in their own browser.

Guidance for AI coding agents working in this repo. The full conventions live in README.md — read it before making changes.

Non-obvious facts:

The dev server starts a mock API on port 8787 (mock/server.mjs) and proxies /api to it. There is no real backend; data comes from useSWR hooks in src/api/hooks.ts.
Both themes are driven by CSS variables at the top of src/index.css. Use semantic Tailwind tokens (bg-card, text-muted-foreground), never raw hex values, or dark mode breaks.
The look is Stackship: Poppins, blue primary + green accent, the blue→green gradient as an accent (text-gradient, bg-brand), large radii (rounded-xl = 20px), Lucide icons. No purple/pink SaaS gradients, no emoji.
Fonts are bundled with Fontsource on purpose — don't add Google Fonts or other CDN links; Stackship apps often run on clusters without internet egress.
React Compiler is enabled — keep components pure; don't add manual memoization.
npm run build type-checks; run it before declaring work done.