KnearMe Portfolio Troubleshooting

Build fails on widget step

Symptom: build fails before Next.js build completes.

Checks:

pnpm -C apps/knearme-portfolio run build:widget

Fix: resolve dependency or compile issue in mcp-server/widgets before retrying full build.

E2E instability

Symptom: mock E2E failures in local runs.

Checks:

pnpm -C apps/knearme-portfolio exec playwright install --with-deps chromium
pnpm -C apps/knearme-portfolio test:e2e:mock

Fix: reinstall browsers, verify mock mode env values, clear stale output artifacts.

Incorrect canonical URL output

Symptom: links/sitemaps render wrong domain.

Check NEXT_PUBLIC_SITE_URL in environment and deployment settings.

API write-route errors in production

Symptom: elevated 4xx/5xx on /api/track, /api/forms/submit, newsletter/email paths.

Action: verify Cloudflare edge route ownership and rollback route for affected path if needed.