# 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](./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.