# Build Instructions — Portfolio Page ## Prerequisites - **Build tool**: pnpm 12.11.2 (`packageManager` in `web/package.json`), Node 24 - **Dependencies**: from `web/pnpm-lock.yaml`; no new dependency in this feature - **Environment variables**: none - **System**: any OS supported by Node 24; Chrome for Lighthouse ## Build Steps ```bash cd web pnpm install --frozen-lockfile # also runs `chakra typegen` (theme: swap duration, filterControl recipe) pnpm build # tsc && vite build ``` ## Verify - `dist/` with, among others, `assets/portfolio-*.js` (route, ~2.6 kB gzip), `assets/Lightbox-*.js` (lazy chunk, ~15.4 kB gzip), `assets/index-*.js` (main, ~150 kB gzip; +0.1 kB gzip versus master), 20 portfolio photos and `og-portfolio.jpg` - `sitemap.xml` lists `/portfolio` - Known warning: chunk size > 500 kB for the main bundle (pre-existing) ## Troubleshooting - **Type errors on Chakra tokens/recipes** after a theme change: run `pnpm typegen`. - **Missing photos**: the assets are committed in `web/src/assets/portfolio/`; they were produced once with a local `System.Drawing` script (not part of the build).