From 59951a72243779b46332811e8b2c169e9afa3138 Mon Sep 17 00:00:00 2001 From: "dong.nguyen" Date: Tue, 6 Oct 2026 11:42:47 +0700 Subject: [PATCH] docs: update AGENTS.md with routing, theming, and gotchas for AI agents --- AGENTS.md | 84 +++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 63 insertions(+), 21 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 2cf5583..4c5fe75 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ ## Project -A bare **React + TypeScript + Vite** application (default `create-vite` scaffold). No custom components, utilities, or business logic yet. +Personal engineering portfolio — multi-page SPA built with React + TypeScript + Vite. Data-driven content from `src/data/`, styled with CSS variables supporting dark/light/system themes. ## Tech Stack @@ -11,6 +11,7 @@ A bare **React + TypeScript + Vite** application (default `create-vite` scaffold | Framework | React 19 | | Language | TypeScript 6 (bundler mode, `verbatimModuleSyntax`, `noEmit`) | | Bundler | Vite 8 | +| Router | React Router DOM v6 (pin `6.30.6` — do NOT upgrade to v7) | | Linter | Oxlint 1 (`plugins: react, typescript, oxc`) | | Package manager | pnpm | @@ -23,32 +24,73 @@ A bare **React + TypeScript + Vite** application (default `create-vite` scaffold | `pnpm lint` | Run Oxlint | | `pnpm preview` | Preview production build locally | -## Project Structure +## Routing + +- `App.tsx` wraps `` → `` → `` (NOT nested `` — causes `children` not to pass) +- Layout: `` (top) → `
` → `