Build, unit, integration and performance test instructions and the summary, the corrected scroll rule and the review on test. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
24 lines
1.5 KiB
Markdown
24 lines
1.5 KiB
Markdown
# Build Instructions — contact-page
|
|
|
|
This feature adds no dependencies, build steps or environment variables.
|
|
|
|
## Prerequisites
|
|
- **Node.js** 24 and **pnpm** (version pinned in `web/package.json`)
|
|
- **Environment variables**: none for the build. `LIGHTHOUSE_PERFORMANCE=warn` only in CI.
|
|
|
|
## Build steps
|
|
```bash
|
|
cd web
|
|
pnpm install # also runs `chakra typegen` (postinstall); needed for the new accent.deeper token
|
|
pnpm build # tsc && vite build
|
|
```
|
|
|
|
## Verify
|
|
- **Expected output**: `✓ built in …` and no TypeScript errors
|
|
- **Artifacts**: `web/dist/`. New in this feature: `dist/assets/contact-*.jpg` and `contact-portret-*.jpg` (hashed), `dist/og-contact.jpg` (stable URL for the preview image), the page chunk `contact-*.js` (4.6 kB) and the shared `ContactForm-*.js` chunk (15 kB), which the homepage and the contact page load on demand
|
|
- **Accepted warning**: Vite's chunk-size warning for the main bundle (known, NFR-P-01)
|
|
|
|
## Troubleshooting
|
|
- **"Port 4173 is already in use"**: a leftover `vite preview` (on Windows, killing the shell does not stop its node process). Check with `Get-NetTCPConnection -LocalPort 4173`, and coordinate with "claim 4173" / "4173 free" with parallel feature sessions.
|
|
- **CI `check` ends with exit code -1 after `pnpm install`, or "lookup github.com … server misbehaving"**: a network/DNS problem on the Pi or the router (seen on 2026-10-25, runs 573 and 574), not the code. Check the router's DNS (`nslookup github.com 192.168.1.1`), then dispatch the run again.
|