Files
SluijsensandClaude Opus 5.5 26106f280f 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>
2026-10-22 23:35:21 +02:00

65 lines
4.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Components — Over mij Page
All paths are under `web/src/`. "Unit" refers to the execution plan (1 = Shared blocks, 2 = Over mij page).
## Shared building blocks (`components/<Name>/`)
### PageSection — changed (unit 1)
- **Was**: `HomeSection` (renamed: folder, file, component, test, all imports). *Source: Q9 = A*
- **Purpose**: frame of a content section on any page (design `.section`): `section` element named by its heading, vertical rhythm, background tone, content column, anchor offset under the fixed header.
- **Change besides the rename**: spacing option `flushTop` — no top padding, for the first block directly under a page head (design `.section--flush-top`). Existing options and output stay identical.
### MediaText — new (unit 1)
- **Purpose**: a photo in the sand-coloured frame next to a text column (design `.about`); stacked on phones and tablets, two equal columns from `lg`, vertically centred. Both columns fade in (`Reveal`).
- **Interface**: layout only — the photo comes in as data, the text column as `children`. *Source: Q1 = A*
- **Used by**: homepage `AboutBlock` (unit 1, no visible change) and `AboutIntro` (unit 2).
- **Reuses**: `FramedImage` (→ `DeferredImage`), `Reveal`, Chakra `Grid`.
### Eyebrow — new (unit 1)
- **Purpose**: the small capitals label above a heading (design `.eyebrow`) in one place: text style `eyebrow`, colour `accent.deep` (meets 4.5:1), standard space below. Renders a `p` by default; with `as="h3"` (or another heading level) it is a real heading that looks like the label. *Source: Q2 = A*
- **Replaces** the four identical inline label blocks in `SectionHeading`, `PageIntro`, `ContactFormGate` and `TestimonialSlide` (same output). Labels that look different on purpose (hero on photos, footer column titles, form labels, nav links, testimonial author line) are left alone.
### PhotoDuo — new (unit 2)
- **Purpose**: two landscape photos side by side at 3:2 (design `.intro-gallery--duo`), one below the other on phones; no stagger, no swipe row. *Source: Q3 = A*
- **Semantics**: a labelled list of figures (`ul`/`li`), each image with its own alt text.
- **Hover**: the design's `.intro-gallery figure:hover img` zoom applies to the duo too, so `PhotoDuo` zooms gently on hover like `IntroGallery`, with `_motionReduce` turning the transition off.
- **Reuses**: `DeferredImage`, `Reveal`, token `gridGap`.
### Existing, reused unchanged
- `PageIntro` (page head with the h1) — only switches to `Eyebrow` internally.
- `SectionHeading` (eyebrow + h2 + lead) — only switches to `Eyebrow` internally.
- `FramedImage`, `DeferredImage`, `Reveal`, `LinkButton` (`accent`), `RouterLink`, Chakra `Link` (`underline` variant).
## Page-specific components (`components/about/`, unit 2) — *Source: Q4 = A*
### AboutIntro
- **Purpose**: the "Hoi! Ik ben Andrea" block: `PageSection` (`flushTop`) → `MediaText` with the portrait → `SectionHeading` (eyebrow "Lifestyle fotograaf", h2, `align="start"`, compact) and the paragraphs, one of which contains the links "mijn portfolio" and "neem contact op".
### StorySection
- **Purpose**: one text block of Andrea's story, used twice ("Hoe het begon", "Buiten de camera om"): `PageSection` (narrow column, tone per use) → `Eyebrow as="h3"` → paragraphs → optional `children` below the text (the "Boek je shoot" button).
### RichParagraph (helper inside `components/about/`, or shared if Functional Design shows a second user)
- **Purpose**: renders one paragraph of the content model in which some words are links (shape defined in Functional Design), mapping link segments to `Link variant="underline"` + `RouterLink`.
## Route
### routes/over-mij.tsx — changed (unit 2)
- `head()`: `pageHead('/over-mij')` plus the `AboutPage` JSON-LD script.
- `component`: `PageIntro` → `AboutIntro` → `StorySection` (Hoe het begon, `paper.alt`) → `PhotoDuo` → `StorySection` (Buiten de camera om, with `LinkButton`).
## Content and SEO modules
### content/aboutContent.ts + `AboutPageContent` in content/types.ts — new (unit 2)
- Page head texts, intro block (eyebrow, title, paragraphs, portrait), two story blocks (title, paragraphs), duo photos, booking button (label, target).
### seo.ts — changed (unit 2)
- New pure builders for the `Person` and `AboutPage` structured data; the business (`professionalService`) gets a stable `@id`.
### sitePages.ts — changed (unit 2)
- `/over-mij`: new title and description, `indexed: true`, `ogImage` → `/og-over-mij.jpg` (1200×630).
### Lighthouse config — changed (unit 2)
- `lighthouserc.cjs` / `.desktop.cjs`: `/over-mij` moves from the noindex to the indexed paths.
## Assets (unit 2)
- `assets/about/`: portrait and two duo photos (resized originals).
- `public/og-over-mij.jpg`: 1200×630 crop of the portrait.