Plans the Over mij page

Refreshes the reverse engineering docs after the homepage sections and
records the requirements, execution plan and application design for the
Over mij page: live texts in the design's structure, an indexed page with
its own structured data and preview image, and shared building blocks
(PageSection, MediaText, Eyebrow) reused by the homepage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-22 23:35:21 +02:00
co-authored by Claude Opus 5.5
parent 99d4610928
commit 26106f280f
21 changed files with 1341 additions and 41 deletions
@@ -31,45 +31,61 @@ graph TD
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"]
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 page;
class navigation,useHeroSlider,LinkButton,RouterLink util;
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 with its sub-components and LinkButton; placeholder routes render PageIntro.
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 homepage-sections feature.
Candidates for modification are marked with ★ for the over-mij-page feature.
- `web/index.html` — HTML entry; static fallback head for non-JS crawlers
- `web/src/main.tsx` — bootstrap
- `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 (`/`), currently only the Hero
- `web/src/routes/{over-mij,portfolio,soorten-fotoshoots,contact,privacyverklaring}.tsx` — placeholders with `PageIntro`
- `web/src/routes/index.tsx` — home (`/`): Hero + six sections, `?pakket=` search param
- ★ `web/src/routes/over-mij.tsx` — placeholder with `PageIntro` (to become the real page)
- `web/src/routes/{portfolio,soorten-fotoshoots,contact,privacyverklaring}.tsx` — placeholders with `PageIntro`
- `web/src/components/AppShell.tsx` — shell
- `web/src/components/NavigationBar/*` — header, NavLink, MobileNav
- `web/src/components/Footer/*` — footer, FooterColumn, FooterLink
- `web/src/components/Hero/*` — hero slider, arrows, pause button, socials, slider hook
- `web/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 (was `HomeSection`)
- ★ `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 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)
- ★ `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/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.tsx`
- ★ `web/src/content/*.ts` — static content (`siteContent`, `heroContent`, `homeContent`, `packages`, `testimonials`, `socialPlatforms`)
- `web/src/contact/*` — contact form types and placeholder submit
- `web/src/hooks/*` — `useRouteFocus`, `useScrolledPast`, `useInView`, `usePageLoaded`, `useReveal`
- `web/src/lib/*.ts` — pure helpers with tests
- `web/src/monitoring/*` — Sentry/Umami config and loader
- `web/src/navigation.ts` — `RoutePath`, `mainNav`, `footerNav`
- ★ `web/src/seo.ts`, `sitePages.ts`, `sitemap.ts` — SEO (home description may change)
- ★ `web/src/seo.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
- `web/src/theme.ts`, `web/src/recipes/*.ts` — design system
- `web/src/test/*` — `renderWithProviders`, axe matcher, fast-check arbitraries, setup
- `web/src/assets/*` — hero photos (8), light/dark logos
- ★ `web/config/securityHeaders.ts` — CSP (only if the contact form posts to a third party)
- `web/src/test/*` — `renderWithProviders`, axe matcher, fast-check arbitraries, `fakeIntersectionObserver`, setup
- `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/deploy/iis/web.config`, `web/deploy/nginx/*.conf` — generated server configs
- `web/public/*` — favicon, logo, og-image, robots.txt, icons.svg
@@ -90,6 +106,15 @@ Candidates for modification are marked with ★ for the homepage-sections featur
- **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