Template
22 lines
1.2 KiB
Markdown
22 lines
1.2 KiB
Markdown
# 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.
|