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>
68 lines
3.8 KiB
Markdown
68 lines
3.8 KiB
Markdown
# Component Dependencies — Over mij Page
|
|
|
|
## Dependency Matrix
|
|
|
|
| Component (uses →) | PageSection | MediaText | Eyebrow | SectionHeading | PhotoDuo | FramedImage | DeferredImage | Reveal | LinkButton | Link + RouterLink |
|
|
|---|---|---|---|---|---|---|---|---|---|---|
|
|
| routes/over-mij.tsx | | | | | ✓ | | | | ✓ | |
|
|
| AboutIntro | ✓ | ✓ | | ✓ | | | | | | ✓ (via RichParagraph) |
|
|
| StorySection | ✓ | | ✓ | | | | | ✓ | | |
|
|
| RichParagraph | | | | | | | | | | ✓ |
|
|
| home/AboutBlock | ✓ | ✓ | | ✓ | | | | | | ✓ |
|
|
| MediaText | | | | | | ✓ | | ✓ | | |
|
|
| PhotoDuo | | | | | | | ✓ | ✓ | | |
|
|
| SectionHeading | | | ✓ | | | | | | | |
|
|
| PageIntro | | | ✓ | | | | | | | |
|
|
| ContactFormGate, TestimonialSlide | | | ✓ | | | | | | | |
|
|
| other home sections | ✓ | | | ✓ | | | ✓ | ✓ | | |
|
|
|
|
The route also uses `PageIntro`, the components in `components/about/`, `content/aboutContent.ts`, `content/siteContent.ts` and `seo.ts`.
|
|
|
|
## Diagram
|
|
|
|
```mermaid
|
|
graph TD
|
|
Route["routes/over-mij.tsx"] --> PageIntro
|
|
Route --> AboutIntro["about/AboutIntro"]
|
|
Route --> Story["about/StorySection (x2)"]
|
|
Route --> PhotoDuo
|
|
Route --> LinkButton
|
|
Route --> Content["content/aboutContent.ts"]
|
|
Route --> Seo["seo.ts + sitePages.ts"]
|
|
AboutIntro --> MediaText
|
|
AboutIntro --> SectionHeading
|
|
AboutIntro --> Rich["about/RichParagraph"]
|
|
Story --> Eyebrow
|
|
Story --> PageSection
|
|
AboutIntro --> PageSection
|
|
HomeAbout["home/AboutBlock"] --> MediaText
|
|
HomeAbout --> PageSection
|
|
MediaText --> FramedImage
|
|
FramedImage --> DeferredImage
|
|
PhotoDuo --> DeferredImage
|
|
SectionHeading --> Eyebrow
|
|
PageIntro --> Eyebrow
|
|
classDef route fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
|
|
classDef newpart fill:#FFA726,stroke:#E65100,stroke-width:1px,color:#000;
|
|
classDef changed fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
|
|
classDef existing fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
|
class Route route;
|
|
class AboutIntro,Story,Rich,PhotoDuo,MediaText,Eyebrow,Content newpart;
|
|
class PageSection,HomeAbout,SectionHeading,PageIntro,Seo changed;
|
|
class FramedImage,DeferredImage,LinkButton existing;
|
|
```
|
|
|
|
Text alternative: the route composes PageIntro, AboutIntro, two StorySections, PhotoDuo and LinkButton from aboutContent and the SEO module; AboutIntro and the homepage AboutBlock both use MediaText and PageSection; StorySection, SectionHeading and PageIntro use the new Eyebrow; MediaText and PhotoDuo rely on FramedImage/DeferredImage (new in orange, changed in blue, existing in grey).
|
|
|
|
## Communication Patterns
|
|
- **Props down only**: content flows from the route into components; no context, store or fetching. Components stay presentational and testable in isolation.
|
|
- **Heading ids**: each section component owns a constant title id (as on the homepage) or receives one (`StorySection` is used twice, so the route passes `titleId`), and passes it to `PageSection labelledBy`.
|
|
- **Theme coupling**: components reference tokens by name (`paper.alt`, `gridGap`, `accent.deep`, text styles); no literal colours.
|
|
|
|
## Data Flow
|
|
`aboutContent.ts` (static data, image imports) → route → page components → shared blocks → Chakra primitives. Head data: `sitePages.ts` + `siteContent.ts` → `seo.ts` builders → route `head()` → `HeadContent` in the root route.
|
|
|
|
## Change Order (from the dependencies)
|
|
1. Unit 1: `Eyebrow` → switch `SectionHeading`/`PageIntro`/`ContactFormGate`/`TestimonialSlide` → rename `HomeSection` → `PageSection` (+ `flushTop`) → `MediaText` → switch `AboutBlock`. Homepage output unchanged after each step.
|
|
2. Unit 2: assets → content types and data → `seo.ts`/`sitePages.ts` → `PhotoDuo`, `components/about/*` → route → Lighthouse config → LAYOUT.md.
|