Workspace detection, a reverse engineering delta, requirements with the approved layout mockups, the execution plan and the application design for the Contact page, plus the code generation plan and summary of the webPage helper. Corrects the contact payload in the shared API notes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.8 KiB
6.8 KiB
API Documentation
REST APIs
None. There is no back-end yet (api/ is empty). The static design README anticipates these endpoints on a .NET API:
POST /api/contact— contact form; the design README names the payload{ naam, email, onderwerp, bericht }, the code sends{ naam, email, shoot, bericht }(homepage-sections turnedonderwerpinto the shoot choice); maps to a C#ContactRequestrecord/api/pages,/api/portfolio,/api/packages— CMS content
Internal APIs
Routes (TanStack Router, file-based)
| Path | File | Head | Component | Indexed |
|---|---|---|---|---|
| (root) | routes/__root.tsx |
siteHead(siteContent) |
AppShell |
— |
/ |
routes/index.tsx |
pageHead('/') |
Hero + six home sections; search ?pakket= |
yes |
/over-mij |
routes/over-mij.tsx |
pageHead('/over-mij') + AboutPage JSON-LD |
PageIntro, AboutIntro, StorySection ×2, PhotoDuo, LinkButton |
yes |
/portfolio |
routes/portfolio.tsx |
pageHead(...) |
PageIntro placeholder |
no |
/soorten-fotoshoots |
routes/soorten-fotoshoots.tsx |
pageHead('/soorten-fotoshoots') + WebPage JSON-LD (webPage() + shootServices()) |
PageIntro, shoots/ShootList (5× ShootBlock), CallToAction, RichParagraph, LinkButton |
yes |
/contact |
routes/contact.tsx |
pageHead(...) |
PageIntro placeholder |
no |
/privacyverklaring |
routes/privacyverklaring.tsx |
pageHead(...) |
PageIntro placeholder |
no |
| (not found) | — | — | NotFound |
— |
seo.ts / sitePages.ts / sitemap.ts
pageHead(path: RoutePath)→{ meta, links }(title, description, robots noindex if not indexed, OG tags, canonical)siteHead(content: SiteContent)→{ meta, scripts }(OG basics, JSON-LD ProfessionalService)canonicalUrl(path, base?),jsonLdScript(data),structuredDataScript(data),professionalService(content)(with@idbusinessIdandfounder→personId),person(content, site, image),aboutPage(path, content, site)sitePages: Record<RoutePath, PageMeta>,pageList(pages)sitemapXml(...)— used byconfig/sitemapPlugin.ts
Components (props)
AppShell(),NavigationBar(),BackToTop(),NotFound()— no propsMobileNav({ id, open, onClose }),NavLink(RouterLink props)Footer({ content: SiteContent }),FooterColumn({ title, children }),FooterLink(LinkProps)Hero({ content: HeroContent, socials: SocialLink[] }),HeroArrows({ onPrev, onNext }),HeroPauseButton({ stopped, onToggle }),HeroSocials({ socials })PageIntro({ title, eyebrow?, children? })— renders the page's only h1PageSection({ labelledBy, id?, tone?: 'paper' | 'alt', width?: 'default' | 'narrow' | 'full', spacing?: 'default' | 'tight' | 'flushTop', 'data-testid'?, children })(wasHomeSection)MediaText({ image, aspectRatio, priority?, reverse?, frameColor?, 'data-testid'?, children })— framed photo next to a text column;reverseputs the photo right fromlg,frameColorcolours the block behind it (defaultsand)CallToAction({ title, titleId, lead?, 'data-testid'?, children })— closing block of a page: h2, lead, action, onpaper.altRichParagraph({ paragraph: RichText })— paragraph with inline links (moved fromabout/)Eyebrow(TextProps & { as?: 'p' | 'span' | 'h2' | 'h3' | 'h4' })— accent label, optionally a headingSectionHeading({ id, title, eyebrow?, lead?, align?: 'center' | 'start', spacing?: 'default' | 'compact', focusable? })— renders an h2FramedImage({ image: ContentImage, aspectRatio }),DeferredImage(ImageProps & { image, near? }),Reveal(BoxProps & { delay? })IntroGallery({ content }),AboutBlock({ content }),Pricing({ content, packages }),PriceCard(...),Testimonials({ content, testimonials }),ContactSection({ content, packages, enabled, email, pakket? }),InstagramGrid({ content, profileUrl })ContactForm(...),ContactFormGate({ enabled, email, ... })PhotoDuo({ photos: [ContentImage, ContentImage], label, 'data-testid'? })about/AboutIntro({ content }),about/StorySection({ content, titleId, tone?, spacing?, children? }),shoots/ShootList({ shoots, packages, portfolioLive }),shoots/ShootBlock({ shoot, packages, reverse, priority, portfolioLive })StatusPage({ title, children, actions? }),ErrorPage({ error, reset })LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })UmamiAnalytics({ hostname? })
Hooks
useHeroSlider(count)→ slider state, controls, handlers,HeroAnnouncementuseScrolledPast(getThreshold)→ boolean (stablegetThresholdrequired)useRouteFocus()— focuses<main>after navigationuseInView({ rootMargin, skip })→{ ref, inView };usePageLoaded()→ boolean;useReveal()→{ ref, visible }
Pure helpers (lib/)
emailAddress({ user, domain }): string | nullvisibleSocials(socials): SocialLink[]— only valid https linkscopyrightLine(year): stringslidesToLoad(active, count): number[]backToTopThreshold(viewportHeight): numberslideLabel,formatPrice,bookLabel,visiblePackages,visibleTestimonials,packageFromSearch,shootOptions,mailSubject/mailtoLink,validateField/validateContact,isLikelySpam,toContactPayload,contactFormReducer
Monitoring
monitoringFor(hostname): Monitoring | null,startSentry(hostname?),reportError(error)
Data Models
SiteContent (content/types.ts)
- Fields:
footerIntro: string,socials: SocialLink[],email: EmailAddress,contactForm: { enabled: boolean }
ContentImage
- Fields:
src,alt,width,height(intrinsic size, reserves space)
HomeContent
- Fields:
intro,about(eyebrow,title,paragraphs[],image,link: { label, to: RoutePath }),pricing,testimonials,contact,instagram
LinkTarget / InlineLink / RichText
- Fields:
{ to: RoutePath; hash? };InlineLinkaddstext;RichText = (string | InlineLink)[]
AboutPageContent
- Fields:
head,intro(eyebrow, title,paragraphs: RichText[], image),background,photos,personal,booking(label + LinkTarget),person(name, jobTitle, knowsAbout)
PricingPackage / Testimonial
- Fields:
id,name,price,features[]/id,shoot,quote,author,image
SocialLink
- Fields:
platform: SocialPlatform(facebook|instagram),href: string - Validation: shown only if
hrefis a valid https URL
EmailAddress
- Fields:
user,domain— assembled only in the browser; invalid parts → hidden
HeroContent
- Fields:
title,tagline,cta: { label, to },slides: { id, src, alt }[]
NavItem (navigation.ts)
- Fields:
to: RoutePath,label: string
PageMeta (sitePages.ts)
- Fields:
title,description,indexed,ogImage?