Replaces the placeholder with the page from the design and the texts from the live site: Andrea's introduction with her portrait, how it started, two photos, life outside photography and a booking button. The page is now indexed, with its own title, description, preview image and AboutPage data about Andrea. The portrait loads straight away instead of after the page, since on phones it is the largest paint. Lighthouse no longer lets every indexed page use the homepage's lower mobile performance target; it now only applies to the homepage itself. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.6 KiB
9.6 KiB
Code Structure
Build System
- Type: pnpm (
packageManager: pnpm@12.11.2, lockfileweb/pnpm-lock.yaml) - Configuration:
web/package.json— scriptsdev,build(tsc && vite build),preview,test(vitest + coverage),lint,format:check,audit:deps,audit:dev,lighthouse,server-config, andcheck(all of them in sequence)web/vite.config.ts— TanStack Router plugin (autoCodeSplitting) before React plugin, sitemap plugin, security headers on dev/preview, Vitest config (jsdom, 20 s timeout, 100% coverage threshold forsrc/lib/**,seo.ts,sitemap.ts)web/tsconfig.json— bundler mode,@/*→src/*web/eslint.config.js— JS + typescript-eslint + react-hooks + jsx-a11y recommendedweb/.prettierrc— 4 spaces, single quotes, semicolonsweb/lighthouserc.cjs/.desktop.cjs— Lighthouse CI againstpnpm preview(accessibility and best practices 1.0, performance 0.9; home mobile 0.8).gitea/workflows/continuous_integration.yaml— jobscheck,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
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, 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,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— HTML entry; static fallback head for non-JS crawlersweb/src/main.tsx— bootstrapweb/src/routeTree.gen.ts— generated (do not edit)web/src/routes/__root.tsx— root layout, site head, 404/errorweb/src/routes/index.tsx— home (/): Hero + six sections,?pakket=search paramweb/src/routes/over-mij.tsx— the about page (indexed;AboutPageJSON-LD)web/src/components/about/*—AboutIntro,StorySection,RichParagraphweb/src/components/PhotoDuo/PhotoDuo.tsx— two photos side by sideweb/src/content/aboutContent.ts— about page content;web/src/assets/about/*— portrait and duo photos;web/public/og-over-mij.jpg— preview imageweb/src/routes/{portfolio,soorten-fotoshoots,contact,privacyverklaring}.tsx— placeholders withPageIntroweb/src/components/AppShell.tsx— shellweb/src/components/NavigationBar/*— header, NavLink, MobileNavweb/src/components/Footer/*— footer, FooterColumn, FooterLinkweb/src/components/Hero/*— hero slider, arrows, pause button, socials, slider hookweb/src/components/home/*— the six homepage sections (AboutBlock is the closest relative of the Over mij page's first block)- ★
web/src/components/PageSection/PageSection.tsx— section frame for any page (wasHomeSection) - ★
web/src/components/MediaText/MediaText.tsx,Eyebrow/Eyebrow.tsx— framed photo next to text; accent label - ★
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 web/src/components/ContactForm/*— contact form and gateweb/src/components/BackToTop/BackToTop.tsx— back-to-top buttonweb/src/components/Analytics/UmamiAnalytics.tsx— Umami script injection- ★
web/src/components/PageIntro/PageIntro.tsx— page head block (eyebrow, h1, intro) web/src/components/StatusPage/*— StatusPage layout, NotFound, 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,packages,testimonials,socialPlatforms) web/src/contact/*— contact form types and placeholder submitweb/src/hooks/*—useRouteFocus,useScrolledPast,useInView,usePageLoaded,useRevealweb/src/lib/*.ts— pure helpers with testsweb/src/monitoring/*— Sentry/Umami config and loaderweb/src/navigation.ts—RoutePath,mainNav,footerNav- ★
web/src/seo.ts,sitePages.ts,sitemap.ts— SEO (/over-mijisindexed: falsetoday) - ★
web/lighthouserc.cjs/.desktop.cjs— own list of indexed/noindex paths, guarded by a test web/src/theme.ts,web/src/recipes/*.ts— design systemweb/src/test/*—renderWithProviders, axe matcher, fast-check arbitraries,fakeIntersectionObserver, setupweb/src/assets/*— hero photos (8),home/(intro 1–4, andrea, deco 1–2, two review photos), light/dark logosweb/config/securityHeaders.ts— CSPweb/config/serverConfig.ts,writeServerConfig.ts,sitemapPlugin.ts,testSeed.tsweb/deploy/iis/web.config,web/deploy/nginx/*.conf— generated server configsweb/public/*— favicon, logo, og-image, robots.txt, icons.svg
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:
defineConfigtokens/semanticTokens/textStyles,defineRecipe+useRecipe
Section composition
- Location:
components/home/*on top ofPageSection,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_IDconstant per section;data-testidon the section root; validity filters inlib/(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 byRoutePath - Purpose: One source for head tags and the sitemap;
indexed: falsefor 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.tsin 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.tson install
@tanstack/react-router ^1.170.39 (+ router-plugin ^1.168.40)
- Usage: File-based routes,
Link,Outlet,HeadContent, typedRoutePath
@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)