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>
65 lines
4.7 KiB
Markdown
65 lines
4.7 KiB
Markdown
# 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.
|