App documentation (docs/web)
Guides for the Nuxt app @tgmc/web (core/web).
Hub: Catalog · Agents: docs/agents/README.md · CI/CD: docs/cicd.md · Public IA / launch: portfolio-august-launch.md
Public chrome (restyle IA)
Primary navigation (AppPrimaryNav): Work → /work, About → /about, Gallery → /gallery, Writing → /blog, Code → /code.
Work sub-navigation (AppWorkSubNav on /work and /work/[slug]): Docs → /docs, AI Lab → /ai-lab, Process → /process. Secondary demos (/media-player, /product, /styles) stay off the primary rail.
Shipped page layouts (ember brand; sparse --portfolio-teal on About résumé, Gallery stats, Code language tags):
| Surface | Layout notes |
|---|---|
| Home | Fluid split hero (data-fit="screen"); ambient video confined to .home-hero__visual; focus tags + view-all |
| About | Digital CV sidebar + portrait + sticky on-page nav (data-fit="prose"); teal résumé download |
| Gallery | Social feed/grid; default grid; teal engagement stats; kind badge + category |
Writing (/blog) |
Editorial shelf (content/writing.json essays + /api/posts notes) — not a flat “Notes” list |
| Code | Editor chrome + explorer/repos; teal language tags; snippet browser from content/code.json (samples, MSE, AI Lab, contrast, helix) |
| Work | Case-study grid + evidence dialog; Related sub-nav for Docs / AI Lab / Process |
Theme tokens and data-fit: packages/theme.md. Gallery + /docs hubs: features/gallery-and-docs.md.
Getting started
Features
- CDN guide · CDN quick start
- Messages API
- Docker-only admin
- Page data loading
- Gallery and technical docs
- Theme layout / page fit (
data-fit, ratios, container fit) - Data stores (SQLite / Postgres / DynamoDB)
Reference
- Project structure
- Architecture hub — System C4 · API UML · Wireframes · Sequences
- Site person identity — formal / casual / short name variants
- TypeScript types
- TypeScript config
Commands
From repo root (not core/web alone):
npm run dev
npm run build
npm test
npm run lint
NUXT_APP_CDN_URL=https://cdn.example.com npm run build
Source
| Path | Role |
|---|---|
core/web/nuxt.config.ts |
Aliases, Nitro, runtimeConfig, CDN |
core/web/package.json |
App scripts |
core/admin/ |
Docker-only admin — admin.md |
.env*.example |
Env templates (see .env.admin.example for admin stack) |