Refreshes the shared reverse engineering docs, adds the requirements, application design and units for the homepage-sections feature, and updates the static design: live prices and form fields, the new Lieve woorden block and the coming-soon gate over the contact form. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.0 KiB
7.0 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"]
Placeholder["routes/contact.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 page;
class navigation,useHeroSlider,LinkButton,RouterLink util;
Text alternative: the root route renders AppShell (NavigationBar, Footer, BackToTop, Umami); NavigationBar and Footer read navigation.ts; the index route renders the Hero with its sub-components and LinkButton; placeholder routes render PageIntro.
Existing Files Inventory
Candidates for modification are marked with ★ for the homepage-sections 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/error- ★
web/src/routes/index.tsx— home (/), currently only the Hero web/src/routes/{over-mij,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/BackToTop/BackToTop.tsx— back-to-top buttonweb/src/components/Analytics/UmamiAnalytics.tsx— Umami script injectionweb/src/components/PageIntro/PageIntro.tsx— page head block (eyebrow, h1, intro)web/src/components/StatusPage/*— StatusPage layout, NotFound, ErrorPageweb/src/components/LinkButton.tsx,RouterLink.tsx— router links (button style / Chakra-wrapped)- ★
web/src/content/types.ts— content interfaces (API shape) - ★
web/src/content/siteContent.ts,heroContent.ts,socialPlatforms.ts— static content web/src/hooks/useRouteFocus.ts,useScrolledPast.tsxweb/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 (home description may change) web/src/theme.ts,web/src/recipes/*.ts— design systemweb/src/test/*—renderWithProviders, axe matcher, fast-check arbitraries, setupweb/src/assets/*— hero photos (8), light/dark logos- ★
web/config/securityHeaders.ts— CSP (only if the contact form posts to a third party) web/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
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)