Milestone 3

frontend/README.md

@@ -0,0 +1,39 @@
+# Metamorph frontend
+
+Vite + React 18 + TypeScript + TailwindCSS. Design tokens from `../tasks/design.md` are in `tailwind.config.ts`.
+
+## Local dev
+
+```bash
+npm install
+npm run dev          # http://localhost:5173 (proxies /api/* to http://localhost:8000)
+```
+
+## Build
+
+```bash
+npm run build        # outputs to dist/
+npm run preview      # serves dist/ on http://localhost:8080
+```
+
+## Quality
+
+```bash
+npm run typecheck
+npm run lint
+npm run format
+```
+
+## Layout
+
+```
+src/
+├── App.tsx                  # M0 home page (health check + design tokens demo)
+├── main.tsx
+├── index.css                # Tailwind base + tinted-accent utilities
+├── components/ui/           # RTOps design primitives: Card, Tag, SectionHeader, FlowNode, Button
+├── lib/
+│   ├── api.ts               # fetch wrapper (M2 will replace with auth-aware client)
+│   └── cn.ts                # classnames + ACCENTS palette
+└── vite-env.d.ts
+```