Refreshes the shared reverse engineering docs, adds the requirements, application design and units for the homepage-sections feature, and updates the static design: live prices and form fields, the new Lieve woorden block and the coming-soon gate over the contact form. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5.5 KiB
5.5 KiB
Components — homepage-sections
Folder structure per design Q1 = B: the six homepage blocks live under components/home/; anything reusable elsewhere stays directly under components/.
Overview
graph TD
Route["routes/index.tsx"] --> Hero["Hero (exists)"]
Route --> Intro["home/IntroGallery"]
Route --> About["home/AboutBlock"]
Route --> Pricing["home/Pricing"]
Route --> Testimonials["home/Testimonials"]
Route --> ContactSection["home/ContactSection"]
Route --> Instagram["home/InstagramGrid"]
Pricing --> PriceCard["home/Pricing/PriceCard"]
ContactSection --> Gate["ContactForm/ContactFormGate"]
Gate --> Form["ContactForm/ContactForm"]
About --> Framed["FramedImage"]
Testimonials --> Framed
Intro --> Shared["HomeSection + SectionHeading + Reveal"]
About --> Shared
Pricing --> Shared
Testimonials --> Shared
ContactSection --> Shared
Instagram --> Shared
classDef route fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
classDef home fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
classDef shared fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
classDef existing fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
class Route route;
class Intro,About,Pricing,PriceCard,Testimonials,ContactSection,Instagram home;
class Gate,Form,Framed,Shared shared;
class Hero existing;
Text alternative: the home route renders the existing Hero and six new home sections; Pricing uses PriceCard, ContactSection wraps the reusable ContactForm in a ContactFormGate, AboutBlock and Testimonials share FramedImage, and every section uses HomeSection, SectionHeading and Reveal.
Shared components (components/)
HomeSection
- Purpose: the design's
.sectionwrapper for a content block - Responsibilities: vertical padding (
section-y), optionalpaper.altbackground (tone), optional tight padding,Containerwidth (default or narrow),aria-labelledbypointing at its heading, optionalid(anchor) - Interface:
<HomeSection labelledBy tone? width? spacing? id?>children</HomeSection>
SectionHeading
- Purpose: the design's
.section__head - Responsibilities: optional eyebrow (
eyebrowtext style,accent.deep), the h2 (withidforaria-labelledby), optional lead (ink.soft); centred or start-aligned - Interface:
<SectionHeading id title eyebrow? lead? align?>
Reveal
- Purpose: the design's
.revealfade-in on scroll - Responsibilities: wraps children; hidden-then-visible transition once the element enters the viewport; immediately visible under reduced motion, without IntersectionObserver, or before JavaScript runs (no content hidden by default in markup)
- Interface:
<Reveal delay?>children</Reveal>; logic inhooks/useReveal.ts
FramedImage
- Purpose: the photo with the sand offset block behind it (
.about__media), shared by AboutBlock and Testimonials (design Q6 = A) - Responsibilities: image with fixed aspect ratio,
loading="lazy", explicit width/height; decorative offset block hidden belowsm - Interface:
<FramedImage image aspectRatio>
ContactForm (components/ContactForm/)
- ContactForm — the form itself: fields Naam, E-mail, shoot select, Bericht; honeypot; per-field errors via Chakra
Field; submit button; status message. Owns its form state. Reusable on/contactlater. - ContactFormGate — wraps ContactForm; when
enabledis false the form is dimmed andinertand the coming-soon notice with the mail button is shown over it; when true the form is shown as is. - submitContactForm (
src/contact/submitContactForm.ts) — the single submission adapter (see services.md).
Homepage sections (components/home/)
| Component | Unit | Purpose | Key responsibilities |
|---|---|---|---|
IntroGallery |
1 Lifestyle fotografie | Heading + four-photo gallery | Staggered 4-column grid (2 on tablet, 1 on mobile), hover zoom, alt texts |
AboutBlock |
2 Over mij | Photo + intro text | FramedImage, eyebrow, h2, paragraphs, "Lees mijn verhaal" link to /over-mij, paper.alt |
Pricing + PriceCard |
3 Prijzen | Package cards | Decorations, card grid (1 column below lg), price formatting, "Boek je shoot" link with pakket search param + #contact |
Testimonials |
4 Lieve woorden | One review at a time | Chakra Carousel (no autoplay), FramedImage, quotation mark, shoot label, Blockquote, author; prev/next + indicators; live-region status; no controls for a single review; paper.alt |
ContactSection |
5 Contact | Contact block | Heading + lead, id="contact", ContactFormGate with ContactForm, passes the preselected package and the e-mail address |
InstagramGrid |
6 Instagram | Heading + photo grid | Handle link, six tiles (6/3/2 columns) linking to the profile, external link attributes; not rendered without a valid Instagram profile URL |
Modified existing components / modules
| File | Change |
|---|---|
routes/index.tsx |
Renders the six sections after the Hero; validateSearch for pakket |
content/types.ts |
New content interfaces (see component-methods.md) |
content/siteContent.ts |
contactForm: { enabled: false } (design Q5 = A) |
recipes/linkButton.ts |
Usable on a <button> (submit) — no new variant |
theme.ts |
Possibly a sectionY spacing token and field styling (Functional Design / code plan decide) |
test/arbitraries.ts |
Generators for packages, contact values, testimonials |