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, items in shared/primary-nav.ts): About → /about, Work → /work, Gallery → /gallery, Code → /code, Writing → /blog — shown inline with the current page marked from 768 px; below that they sit in the Menu dropdown (a disclosure under the header, not a sheet; site-header.md). Every case study ends with previous / next story and Get in touch (AppStoryPager); each work card is a single link. Splash routes omit Get in touch and “Portfolio App” billing. About résumé/contact and the Gallery walkthrough CTA stay public view-only exceptions. When skip is on, Menu includes Doors → /splash and header actions include On view → /work/media-systems.
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 (brand roles + sparse --portfolio-teal on About résumé, Gallery stats, Code language tags):
| Surface | Layout notes |
|---|---|
| Home | Three-door splash on / and /splash; skip on / uses home-landing middleware; interiors persist via storage cookie driver |
| 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
- App SCSS variables / globals
- Personalization (brand roles)
- Theme Studio preset research
- 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) |
Top-level keys in core/web/nuxt.config.ts and core/admin/nuxt.config.ts follow the order of the nuxt/nuxt-config-keys-order lint rule (extends first, then modules, …, hooks, then module options such as i18n, icon, image). After adding a key, npx eslint --fix sorts it; the order never changes behaviour (layer order lives inside extends).
Code and documentation readers
Runtime flows connects source, content delivery and theme application. Documentation coverage defines sample and diagram maintenance.