Files
AndreaSlopFotografie/aidlc-docs/features/frontend-shell/construction/build-and-test/integration-test-instructions.md
T
SluijsensandClaude Opus 5.5 069c7cb7eb Adds AI-DLC construction docs for the front-end shell feature
Functional design, NFR requirements, code generation plan and summary,
and build-and-test instructions with results.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:05:03 +02:00

2.1 KiB

Integration Test Instructions — frontend-shell

Purpose

This feature is a single unit, so there are no cross-unit or cross-service calls. Integration here means the real app wired together:

  • the generated route tree
  • router options as in main.tsx (scroll restoration, default error component)
  • the Chakra theme
  • the shell around every page
  • the head management per route
  • the build-time sitemap

Automated scenarios (src/app.test.tsx, part of pnpm test)

# Scenario Expected
1 Every route in sitePages renders Inside the shell (banner + contentinfo), exactly one h1, no axe violations
2 /portfolio head Title "Portfolio | Andrea Slop Fotografie", canonical https://andreaslop.nl/portfolio, robots: noindex
3 Structured data Exactly one application/ld+json block of type ProfessionalService
4 Unknown URL /bestaat-niet "Pagina niet gevonden" inside the shell, no axe violations
5 A page throws while rendering "Er ging iets mis" inside the shell; error text not shown
6 Page registry vs route tree Same set of paths (BR-SEO-07)
7 Page registry vs Lighthouse URLs lighthouserc.cjs lists the same indexed / noindex pages

Also in pnpm test: useRouteFocus (focus moves to main after a page change) and NavigationBar/Footer with a real router (aria-current, link targets).

Build-level checks (run after pnpm build + pnpm preview)

Check How Expected
Deep link served curl -s -o /dev/null -w "%{http_code}" http://localhost:4173/portfolio 200 (SPA fallback)
Sitemap curl http://localhost:4173/sitemap.xml 200, text/xml, only https://andreaslop.nl/
Robots curl http://localhost:4173/robots.txt 200, points to the sitemap
E-mail address not in build grep -rl "info@andreaslop" dist No result (BR-EMAIL-01)
No devtools in build ls dist/assets | grep -i devtool No result (NFR-P-04)

Setup and cleanup

  • Setup: no services. The automated tests use an in-memory router history and jsdom.
  • Cleanup: stop pnpm preview (Ctrl+C).