Inital template

AGENTS.md

@@ -0,0 +1,21 @@
+# 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.