Files
AndreaSlopFotografie/aidlc-docs/features/homepage-sections/inception/application-design/components.md
T
SluijsensandClaude Opus 5.5 c81dcd3979 Adds the inception docs and design for the homepage sections
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>
2026-10-19 23:46:30 +02:00

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 .section wrapper for a content block
  • Responsibilities: vertical padding (section-y), optional paper.alt background (tone), optional tight padding, Container width (default or narrow), aria-labelledby pointing at its heading, optional id (anchor)
  • Interface: <HomeSection labelledBy tone? width? spacing? id?>children</HomeSection>

SectionHeading

  • Purpose: the design's .section__head
  • Responsibilities: optional eyebrow (eyebrow text style, accent.deep), the h2 (with id for aria-labelledby), optional lead (ink.soft); centred or start-aligned
  • Interface: <SectionHeading id title eyebrow? lead? align?>

Reveal

  • Purpose: the design's .reveal fade-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 in hooks/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 below sm
  • 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 /contact later.
  • ContactFormGate — wraps ContactForm; when enabled is false the form is dimmed and inert and 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