Files
SluijsensandClaude Opus 5.5 b6d5a85e41 Applies the owner's Lighthouse targets
Three pages no longer need an exception and the homepage target rises to its
measured score, so the gain cannot slip away unnoticed. Also adds the third
unit's code summary and updates the shared docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 20:07:24 +01:00

17 KiB
Raw Permalink Blame History

Code Structure

Build System

  • Type: pnpm (packageManager: pnpm@12.11.2, lockfile web/pnpm-lock.yaml)
  • Configuration:
    • web/package.json — scripts dev, build (tsc && vite build and the script step config/externalizeInlineScripts.ts; prerendering), preview (config/previewServer.ts), e2e (browser tests), test (vitest + coverage), lint, format:check, audit:deps, audit:dev, lighthouse, server-config, and check (all of them in sequence, e2e added by prerendering)
    • web/vite.config.ts — TanStack Start plugin with prerendering (prerendering; replaces the router plugin, code splitting included) before React plugin, sitemap plugin, security headers on dev/preview, Vitest config (jsdom, 20 s timeout, 100% coverage threshold for src/lib/**, seo.ts, sitemap.ts)
    • web/tsconfig.json — bundler mode, @/* → src/*
    • web/eslint.config.js — JS + typescript-eslint + react-hooks + jsx-a11y recommended
    • web/.prettierrc — 4 spaces, single quotes, semicolons
    • web/lighthouserc.cjs / .desktop.cjs — Lighthouse CI against pnpm preview (accessibility and best practices 1.0, performance 0.9; mobile exceptions in a table with a recorded decision per page, 0.85 for /, zwangerschap, gezin, loveshoot and portret; the not-found page is audited through /__audit/404)
    • .gitea/workflows/continuous_integration.yaml — jobs check, deploy-test, lighthouse, deploy-production

Key Classes/Modules

graph TD
    Root["routes/__root.tsx"] --> AppShell["components/AppShell.tsx"]
    AppShell --> NavigationBar["NavigationBar/NavigationBar.tsx"]
    AppShell --> Footer["Footer/Footer.tsx"]
    AppShell --> BackToTop["BackToTop/BackToTop.tsx"]
    AppShell --> Umami["Analytics/UmamiAnalytics.tsx"]
    NavigationBar --> NavLink["NavigationBar/NavLink.tsx"]
    NavigationBar --> MobileNav["NavigationBar/MobileNav.tsx"]
    NavigationBar --> navigation["navigation.ts"]
    Footer --> navigation
    navigation --> shootNavItems["lib/shootNavItems.ts"]
    navigation --> shootTypes["content/shootTypes.ts"]
    Index["routes/index.tsx"] --> Hero["Hero/Hero.tsx"]
    Hero --> HeroArrows["Hero/HeroArrows.tsx"]
    Hero --> HeroPause["Hero/HeroPauseButton.tsx"]
    Hero --> HeroSocials["Hero/HeroSocials.tsx"]
    Hero --> useHeroSlider["Hero/useHeroSlider.ts"]
    Hero --> LinkButton["components/LinkButton.tsx"]
    LinkButton --> RouterLink["components/RouterLink.tsx"]
    Index --> HomeParts["home/*: IntroGallery, AboutBlock, Pricing, Testimonials, ContactSection; shared InstagramGrid"]
    HomeParts --> PageSection["PageSection/PageSection.tsx"]
    HomeParts --> SectionHeading["SectionHeading/SectionHeading.tsx"]
    HomeParts --> Reveal["Reveal/Reveal.tsx"]
    HomeParts --> FramedImage["FramedImage/FramedImage.tsx"]
    FramedImage --> DeferredImage["DeferredImage/DeferredImage.tsx"]
    HomeParts --> DeferredImage
    Placeholder["routes/over-mij.tsx and other placeholders"] --> PageIntro["PageIntro/PageIntro.tsx"]
    classDef shell fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
    classDef page fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
    classDef util fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
    class Root,AppShell,NavigationBar,Footer,BackToTop,Umami,NavLink,MobileNav shell;
    class Index,Hero,HeroArrows,HeroPause,HeroSocials,Placeholder,PageIntro,HomeParts page;
    class navigation,shootNavItems,shootTypes,useHeroSlider,LinkButton,RouterLink,PageSection,SectionHeading,Reveal,FramedImage,DeferredImage util;

Text alternative: the root route renders AppShell (NavigationBar, Footer, BackToTop, Umami); NavigationBar and Footer read navigation.ts; the index route renders the Hero and the six home sections, which are built from the shared PageSection, SectionHeading, Reveal, FramedImage and DeferredImage blocks; placeholder routes render PageIntro.

Existing Files Inventory

Candidates for modification are marked with ★ for the over-mij-page feature.

  • web/index.html and web/src/main.tsx — removed by prerendering; replaced by src/client.tsx (hydration entry, Sentry start), src/router.tsx (getRouter) and the document shell in routes/__root.tsx
  • web/src/routes/$.tsx — catch-all route, renders NotFound (prerendered as 404.html; prerendering)
  • web/src/routeTree.gen.ts — generated (do not edit)
  • web/src/routes/__root.tsx — root layout, site head, 404/error
  • web/src/routes/index.tsx — home (/): Hero + six sections, ?pakket= search param
  • web/src/routes/over-mij.tsx — the about page (indexed; AboutPage JSON-LD)
  • web/src/components/about/* — AboutIntro, StorySection
  • web/src/components/shoots/* — ShootList, ShootBlock (soorten-fotoshoots page; unit 2: "Lees meer over de …" link first in the row, to the shoot page)
  • web/src/components/shoots/ShootPage/ShootPage.tsx — shoot page, ShootPageView in: intro, then the sections in shootPageBands order (unit 2: stories, process, photos, FAQ, package, closing; wrapper data-testid="shoot-page")
  • web/src/components/shoots/{StoryBlocks,ProcessIcons}/ — shoot page parts (unit 2): one PageSection per story (StoryBlocks); the six process icons as inline SVG (ProcessIcons)
  • web/src/components/{Breadcrumb,ProcessTimeline,PhotoMosaic,FaqList,PackageBlock}/ — shoot page parts (unit 2), each with a test
  • web/src/components/StructuredData/StructuredData.tsx — JSON-LD script via jsonLdScript; the only dangerouslySetInnerHTML of the shoot pages
  • web/src/components/{CallToAction,RichParagraph}/ — shared closing block (unit 2 adds tone); paragraph with inline links
  • web/src/content/{shootTypes,shootTypesPageContent}.ts — shoot types (also used by the portfolio filters) and page texts; web/src/assets/shoots/ — 4:5 shoot photos
  • web/src/lib/shootLinks.ts — contact and portfolio link targets per shoot type
  • web/src/lib/{shootPages,shootPackage,fillPlaceholders,richTextToPlain,shootPageView}.ts — shoot page helpers (ids and paths, package, placeholders, plain text, view), each with a test
  • web/src/lib/{headingId,readMoreLabel,mosaicLayout,storyLayout,shootPageBands}.ts — shoot page helpers (unit 2): safe heading ids, "Lees meer" label, photo-mosaic and story layout, section bands; each with a test at 100 % coverage
  • web/src/lib/isShootSectionPath.ts — whether a pathname is under /soorten-fotoshoots/ (FR-ST-14, used by StatusPage/NotFound), with a property-based test
  • web/src/lib/{shootNavItems,navCurrent,navMenuState}.ts — navigation helpers (unit 3), each with a test: submenu items from the shoot types (shootNavItems), current-page and section-current matching (isItemCurrent, isSectionCurrent), menu state reducer (navMenuReducer, NavMenuState, NavMenuEvent; navMenuState.ts at 100 % coverage)
  • web/src/components/PhotoDuo/PhotoDuo.tsx — two photos side by side
  • web/src/content/aboutContent.ts — about page content; web/src/assets/about/* — portrait and duo photos; web/public/og-over-mij.jpg — preview image
  • web/src/routes/soorten-fotoshoots/index.tsx — the shoot types page (moved from routes/soorten-fotoshoots.tsx); newborn.tsx, zwangerschap.tsx, gezin.tsx, loveshoot.tsx, portret.tsx — one route per shoot page (/soorten-fotoshoots/<id>); -shootPageSources.ts — the sources the shoot routes share
  • web/src/content/shootPageShared.ts — shared shoot page content (breadcrumb, process, deposit, shared FAQ items, offer texts); web/src/content/shootPages/*.ts — one content module per shoot page, plus shootPages.test.ts (content consistency)
  • web/src/test/renderApp.tsx — renderApp(path) and expectShell() for the route tests (prerendering: with a test shell instead of the document shell); web/src/test/hydrate.tsx — hydration helpers incl. hydrateAppAsStart
  • web/src/shootPages.test.tsx — route tests for the five shoot pages (unit 2): outline, sections, breadcrumb, aria-current (main and menus), package variants, OG registry, axe; the overview's "Lees meer" links
  • web/src/routes/portfolio.tsx — the portfolio (indexed; ?shoot= filter; ImageGallery JSON-LD); web/src/components/portfolio/PortfolioGallery/, web/src/content/portfolioContent.ts, web/src/lib/portfolioFilters.ts, web/src/assets/portfolio/* (10 photos × 2 sizes), web/public/og-portfolio.jpg
  • web/src/routes/{contact,privacyverklaring}.tsx — placeholders with PageIntro
  • web/src/components/AppShell.tsx — shell
  • web/src/components/NavigationBar/* — header, NavLink (sectionCurrent underline for the parent of an open section), MobileNav (scrolls; Escape returns focus to the hamburger), NavSubmenu (desktop disclosure panel), MobileNavGroup (expandable shoot list on mobile), ChevronIcon, NoScriptNav (two <noscript> menu links, display fallbacks)
  • web/src/components/Footer/* — footer, FooterColumn, FooterLink
  • web/src/components/Hero/* — hero slider, arrows, pause button, socials, slider hook
  • web/src/components/home/* — five homepage sections (AboutBlock is the closest relative of the Over mij page's first block)
  • web/src/components/InstagramGrid/InstagramGrid.tsx — Instagram block, shared by the homepage and the portfolio (moved from home/ in portfolio-page)
  • ★ web/src/components/PageSection/PageSection.tsx — section frame for any page (was HomeSection)
  • ★ web/src/components/MediaText/MediaText.tsx, Eyebrow/Eyebrow.tsx — framed photo next to text; accent label (unit 2 adds mediaSize 'medium')
  • ★ web/src/components/SectionHeading/SectionHeading.tsx — eyebrow + h2 + lead
  • ★ web/src/components/FramedImage/FramedImage.tsx, DeferredImage/DeferredImage.tsx, Reveal/Reveal.tsx — photo blocks and fade-in (display fallbacks: <noscript> twin, visible-by-default Reveal); new web/src/components/NoScript/ (noScriptCss.ts, NoScriptStyles.tsx: all no-JavaScript CSS in one head <noscript><style>); data-requires-js markers on controls that need JavaScript
  • web/src/components/ContactForm/* — contact form and gate
  • web/src/components/BackToTop/BackToTop.tsx — back-to-top button
  • web/src/components/Analytics/UmamiAnalytics.tsx — Umami script injection
  • ★ web/src/components/PageIntro/PageIntro.tsx — page head block (eyebrow, h1, intro; unit 2 adds optional titleId and breadcrumb)
  • web/src/components/StatusPage/* — StatusPage layout, NotFound (unit 2, FR-ST-14: under /soorten-fotoshoots/ buttons back to the overview and to home, decided by lib/isShootSectionPath.ts), ErrorPage
  • ★ web/src/components/LinkButton.tsx, RouterLink.tsx — router links (button style / Chakra-wrapped)
  • ★ web/src/content/types.ts — content interfaces (API shape)
  • ★ web/src/content/*.ts — static content (siteContent, heroContent, homeContent (exports introPhotos), instagramContent, packages, testimonials, socialPlatforms)
  • web/src/contact/* — contact form types and placeholder submit
  • web/src/hooks/* — useRouteFocus, useScrolledPast, useInView, usePageLoaded, useReveal, useSwipe (shared by the hero and the lightbox), useHydrated, useEmailAddress (prerendering: first render equals the prerendered HTML)
  • web/src/hooks/useDismiss.ts — Escape and outside pointer down while active (useDismiss(ref, active, onDismiss)), used by NavSubmenu and MobileNav (unit 3)
  • web/src/components/{PortfolioGrid,Lightbox,FilterBar}/ — gallery building blocks (portfolio-page unit 2): masonry grid in reading order (CSS only), lightbox on Chakra Dialog (lazy-loadable default export), single-choice toggle buttons; generic over GalleryItem / FilterOption
  • web/src/lib/*.ts — pure helpers with tests
  • web/src/monitoring/* — Sentry/Umami config and loader
  • web/src/navigation.ts — RoutePath, NavItem (with children, one level), hasChildren, mainNav (the shoot submenu comes from shootTypes via shootNavItems), footerNav
  • ★ web/src/seo.ts (+ preloadImage), web/src/lib/{revealPhase,firstRow}.ts, sitePages.ts, sitemap.ts — SEO (/over-mij is indexed: false today)
  • ★ web/lighthouserc.cjs / .desktop.cjs — own list of indexed/noindex paths, guarded by a test; data-driven exception table (mobileExceptions) tested in config/lighthouserc.test.ts
  • web/src/theme.ts, web/src/recipes/*.ts — design system
  • web/src/test/* — renderWithProviders, axe matcher, fast-check arbitraries, fakeIntersectionObserver, setup
  • web/src/test/navArbitraries.ts — navigation generators (menu events, menu states, pathnames; unit 3, not in lib/ so the 100 % threshold does not apply); web/src/test/navViewport.ts — viewport helper (matchMedia stub and the lg display rules, because jsdom ignores @media)
  • web/src/assets/* — hero photos (8), home/ (intro 1–4, andrea, deco 1–2, two review photos), light/dark logos
  • web/config/securityHeaders.ts — CSP
  • web/config/serverConfig.ts, writeServerConfig.ts, sitemapPlugin.ts, testSeed.ts
  • web/config/{pageFiles,inlineScripts,externalizeInlineScripts,previewServer,canonicalUrls,compressibleTypes}.ts — prerendering: page file names, moving inline scripts to files after the build, preview server with the real server rules; web/e2e/ and web/vitest.e2e.config.ts — browser tests on dist/client
  • web/deploy/iis/web.config, web/deploy/nginx/*.conf — generated server configs (unit 3: URL contract, gzip block); web/deploy/{check-artifact,verify-deployment,upload-production}.sh — artifact guard, post-deploy check, three-pass FTPS upload (unit 3)
  • web/e2e/{serverRules,deployScripts,urls}.e2e.ts, web/e2e/support/{fixtureSite,nginx}.ts, web/src/test/urlArbitraries.ts — real-nginx tests and parity with the preview server, deploy script tests, URL behaviour in Chrome, URL generators (unit 3)
  • web/public/* — favicon, logo, og-image, robots.txt, icons.svg; og-{newborn,zwangerschap,gezin,loveshoot,portret}.jpg (unit 2: 1200 × 630, the shoot pages' ogImage)

Design Patterns

API-shaped static content

  • Location: content/types.ts + content/*.ts
  • Purpose: Hard-coded today, swappable for API responses later
  • Implementation: Plain data objects typed with interfaces, passed to components as props from the route (or AppShell)

Pure helpers with property-based tests

  • Location: lib/, seo.ts, sitemap.ts
  • Purpose: Logic that decides what is shown (e.g. invalid social → hidden, invalid e-mail → column omitted) lives outside components and is tested with fast-check
  • Implementation: Small exported functions, 100% coverage threshold, shared arbitraries in test/arbitraries.ts

Design tokens + recipes

  • Location: theme.ts, recipes/
  • Purpose: Single source for colours, fonts, spacing, motion; reusable component variants
  • Implementation: defineConfig tokens/semanticTokens/textStyles, defineRecipe + useRecipe

Section composition

  • Location: components/home/* on top of PageSection, MediaText, SectionHeading, Reveal, FramedImage, DeferredImage
  • Purpose: Each section is a thin component that gets its content as a prop and composes the shared blocks; the h2 id links the section landmark (aria-labelledby)
  • Implementation: One TITLE_ID constant per section; data-testid on the section root; validity filters in lib/ (e.g. visiblePackages) decide what is rendered

Deferred below-the-fold images

  • Location: DeferredImage, usePageLoaded, useInView
  • Purpose: Protect the largest contentful paint; photos load only after the load event and near the viewport, with intrinsic width/height reserving space

Page registry

  • Location: sitePages.ts, typed by RoutePath
  • Purpose: One source for head tags and the sitemap; indexed: false for placeholders

Configuration as code for hosting

  • Location: config/securityHeaders.ts → config/serverConfig.ts → deploy/
  • Purpose: Same headers in dev, preview, nginx (test) and IIS (production); a test guards drift

Accessibility by default

  • Location: across components; test/axe.ts in component tests; Lighthouse in CI
  • Implementation: landmarks, skip link, focus management, live regions, visible focus ring, 44px targets, reduced motion

Critical Dependencies

@chakra-ui/react ^3.37.0

  • Usage: All layout and styling; typegen from theme.ts on install

@tanstack/react-router 1.170.46 (+ @tanstack/react-start 1.169.4; prerendering)

  • Usage: File-based routes, static prerendering (Start), Link, Outlet, HeadContent, typed RoutePath

@sentry/react ^11.8.0

  • Usage: Error reporting, lazy-loaded after the load event

@iconify/react ^6.0.2 + @iconify-icons/ant-design 2.0.1

  • Usage: Offline icons (bundled at build time)