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:
@@ -15,10 +15,13 @@ graph TD
|
||||
Shell --> Footer["Footer (FooterColumn, FooterLink)"]
|
||||
Shell --> ToTop["BackToTop"]
|
||||
Shell --> Umami["UmamiAnalytics"]
|
||||
Outlet --> Home["routes/index.tsx: Hero"]
|
||||
Outlet --> Home["routes/index.tsx: Hero + six sections"]
|
||||
Outlet --> Placeholders["over-mij, portfolio, soorten-fotoshoots, contact, privacyverklaring: PageIntro"]
|
||||
Home --> Hero["Hero (HeroArrows, HeroPauseButton, HeroSocials, useHeroSlider)"]
|
||||
Content["content/: siteContent, heroContent, types"] -.-> Shell
|
||||
Home --> Sections["components/home/: IntroGallery, AboutBlock, Pricing, Testimonials, ContactSection, InstagramGrid"]
|
||||
Sections --> Blocks["Shared blocks: PageSection, MediaText, Eyebrow, SectionHeading, FramedImage, DeferredImage, Reveal"]
|
||||
Sections --> Form["ContactForm + ContactFormGate (lazy), contact/"]
|
||||
Content["content/: siteContent, heroContent, homeContent, packages, testimonials, types"] -.-> Shell
|
||||
Content -.-> Home
|
||||
Nav --> NavData["navigation.ts: mainNav, footerNav"]
|
||||
Footer --> NavData
|
||||
@@ -31,11 +34,11 @@ graph TD
|
||||
classDef support fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
||||
class Main,Root entry;
|
||||
class Shell,Skip,Nav,Footer,ToTop,Umami,Outlet shell;
|
||||
class Home,Placeholders,Hero page;
|
||||
class Content,NavData,Seo,Theme support;
|
||||
class Home,Placeholders,Hero,Sections,Form page;
|
||||
class Content,NavData,Seo,Theme,Blocks support;
|
||||
```
|
||||
|
||||
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero, the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
|
||||
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero and six sections built from shared blocks (one of them lazily loads the contact form); the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
|
||||
|
||||
## Component Descriptions
|
||||
### main.tsx
|
||||
@@ -68,21 +71,41 @@ Text alternative: main.tsx starts Sentry and mounts the router; the root route r
|
||||
- **Responsibilities**: Crossfade slides, progress-driven autoplay, arrows, swipe, pause button, pause on hover/focus/hidden tab, reduced motion, live-region announcements, lazy loading of nearby slides, social icons
|
||||
- **Type**: Application
|
||||
|
||||
### components/home/ (homepage sections)
|
||||
- **Purpose**: The six homepage blocks below the hero, in LAYOUT.md order
|
||||
- **Responsibilities**: `IntroGallery` (four photos, swipeable row on phones), `AboutBlock` (framed photo of Andrea + intro + link to `/over-mij`), `Pricing` + `PriceCard` (packages with "Boek" links → `/?pakket=…#contact`), `Testimonials` (+ `TestimonialCarousel`, `TestimonialSlide`), `ContactSection` (lazy `ContactForm` behind `ContactFormGate`, mailto fallback), `InstagramGrid` (fixed tiles linking to the profile)
|
||||
- **Type**: Application
|
||||
|
||||
### Shared section building blocks
|
||||
- **Purpose**: Reusable pieces extracted during homepage-sections; `HomeSection` was renamed to `PageSection` and `MediaText`/`Eyebrow` were extracted in over-mij-page
|
||||
- **Responsibilities**: `PageSection` (section frame: `aria-labelledby`, tone `paper`/`alt`, width `default`/`narrow`/`full`, spacing `default`/`tight`/`flushTop`, anchor offset), `MediaText` (framed photo next to a text column, design `.about`), `Eyebrow` (accent label, optionally a heading), `SectionHeading` (eyebrow + h2 + lead, align start/center, compact spacing), `FramedImage` (photo with sand-coloured offset block, design `.about__media`), `DeferredImage` (loads after page load and near the viewport, reserves space), `Reveal` (fade-in on scroll, content always in the DOM, reduced motion respected)
|
||||
- **Type**: Application (shared UI)
|
||||
|
||||
### components/PageIntro/, StatusPage/
|
||||
- **Purpose**: Shared page building blocks
|
||||
- **Responsibilities**: `PageIntro` — eyebrow, the page's h1 and an intro (used by placeholders); `StatusPage` — layout for 404 and error pages
|
||||
- **Responsibilities**: `PageIntro` — eyebrow, the page's h1 and an intro (used by placeholders; design `.page-head`); `StatusPage` — layout for 404 and error pages
|
||||
- **Type**: Application
|
||||
|
||||
### components/ContactForm/ + contact/
|
||||
- **Purpose**: Contact form, built ahead of the API
|
||||
- **Responsibilities**: `ContactForm` (fields, validation, honeypot + minimum fill time, reducer-driven status), `ContactFormGate` (dims the form under a "coming soon" notice while `siteContent.contactForm.enabled` is false); `contact/submitContactForm.ts` (placeholder submit), `contact/types.ts` (fields, limits, payload)
|
||||
- **Type**: Application
|
||||
|
||||
### content/
|
||||
- **Purpose**: Static content until the CMS API exists
|
||||
- **Responsibilities**: `types.ts` (API-shaped interfaces), `siteContent.ts` (footer intro, socials, e-mail parts), `heroContent.ts` (title, tagline, CTA, slides), `socialPlatforms.ts` (platform → name + offline icon)
|
||||
- **Responsibilities**: `types.ts` (API-shaped interfaces incl. `ContentImage`, `HomeContent`, `PricingPackage`, `Testimonial`), `siteContent.ts` (footer intro, socials, e-mail parts, contact form switch), `heroContent.ts`, `homeContent.ts` (texts and photos of the homepage sections), `packages.ts`, `testimonials.ts`, `socialPlatforms.ts`
|
||||
- **Type**: Application (data)
|
||||
|
||||
### lib/
|
||||
- **Purpose**: Pure, fully tested helpers
|
||||
- **Responsibilities**: `emailAddress`, `visibleSocials`, `copyrightLine`, `slidesToLoad`, `backToTopThreshold`
|
||||
- **Responsibilities**: `emailAddress`, `visibleSocials`, `copyrightLine`, `slidesToLoad`, `backToTopThreshold`, `slideLabel`, `formatPrice`, `bookLabel`, `visiblePackages`, `visibleTestimonials`, `packageFromSearch`, `shootOptions`, `mailLink`, `validateContact`, `isLikelySpam`, `toContactPayload`, `contactFormReducer`
|
||||
- **Type**: Application (utility, 100% coverage threshold)
|
||||
|
||||
### hooks/
|
||||
- **Purpose**: Shared behaviour
|
||||
- **Responsibilities**: `useRouteFocus`, `useScrolledPast`, `useInView` (IntersectionObserver), `usePageLoaded` (after the load event), `useReveal` (reveal once, immediately with reduced motion)
|
||||
- **Type**: Application
|
||||
|
||||
### seo.ts, sitePages.ts, sitemap.ts
|
||||
- **Purpose**: SEO
|
||||
- **Responsibilities**: Page registry (title, description, `indexed`), `pageHead(path)`, canonical URLs, JSON-LD, sitemap generation at build time (via `config/sitemapPlugin.ts`)
|
||||
@@ -100,7 +123,7 @@ Text alternative: main.tsx starts Sentry and mounts the router; the root route r
|
||||
|
||||
### theme.ts / recipes/
|
||||
- **Purpose**: Design system
|
||||
- **Responsibilities**: Colour, font, spacing, easing, duration, z-index tokens; semantic `bg`/`fg`/`focusRing`, `header`/`content`/`pageTop` sizes; `eyebrow`/`display`/`pageTitle` text styles; recipes `container`, `link` (subtle), `linkButton` (outline/accent/light), `iconControl`, `skipNavLink`
|
||||
- **Responsibilities**: Colour (paper/ink/accent/sand/line/error), font, spacing (`gutter`, `sectionY`, `sectionYTight`, `sectionHeadGap`, `gridGap`), easing, duration (`interaction`, `fade`, `reveal`), z-index, shadow, gradient tokens; semantic `bg`/`fg`/`focusRing`, `header`/`content`/`contentNarrow` sizes, `header`/`pageTop` spacing; text styles `eyebrow`/`display`/`sectionTitle`/`lead`/`pageTitle`; recipes `container`, `link` (subtle/underline), `linkButton` (outline/accent/light, size default/fit), `iconControl`, `carouselControl`, `formControl`, `skipNavLink`
|
||||
- **Type**: Application (shared UI foundation)
|
||||
|
||||
## Data Flow
|
||||
@@ -125,7 +148,7 @@ sequenceDiagram
|
||||
Text alternative: a visitor navigates, the router renders the root layout (AppShell), which renders the matched page through the Outlet; the page's head() supplies title/meta from the page registry and focus moves to main.
|
||||
|
||||
## Integration Points
|
||||
- **External APIs**: None yet (planned .NET API for content and the contact form — design README: `POST /api/contact` with `{ naam, email, onderwerp, bericht }`)
|
||||
- **External APIs**: None yet (planned .NET API for content and the contact form; the form already sends `{ naam, email, shoot, bericht }` to a placeholder `submitContactForm` and stays gated off until the API exists)
|
||||
- **Databases**: None
|
||||
- **Third-party Services**: Sentry (errors, EU ingest), Umami at analytics.slpsoftware.nl (cookieless stats), UptimeRobot (availability, external), outbound links to Facebook/Instagram
|
||||
|
||||
|
||||
Reference in New Issue
Block a user