Shoot pages follow design E: breadcrumb, story blocks, process timeline with icons, photo mosaic, FAQ, package block and booking call to action, with per-shoot OG images. The navigation gets a "Soorten fotoshoots" submenu (desktop panel, mobile group) built from shootTypes, with exact current-page matching in menu, footer and breadcrumb. A 404 under /soorten-fotoshoots/ also offers a link back to the overview. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
11 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('/portfolio') + ImageGallery JSON-LD; search ?shoot= (ShootTypeId) |
PageIntro, PortfolioGallery, InstagramGrid |
yes |
/soorten-fotoshoots |
routes/soorten-fotoshoots/index.tsx |
pageHead('/soorten-fotoshoots') + WebPage JSON-LD via StructuredData (webPage() + shootServices(); Service @id …/soorten-fotoshoots/<id>#service per D2) |
PageIntro, shoots/ShootList (5× ShootBlock), CallToAction, RichParagraph, LinkButton |
yes |
/soorten-fotoshoots/<id> (newborn, zwangerschap, gezin, loveshoot, portret) |
routes/soorten-fotoshoots/<id>.tsx |
pageHead('/soorten-fotoshoots/<id>'); JSON-LD via StructuredData (shootPageGraph: WebPage with the shoot's Service, FAQPage when there are questions) |
shoots/ShootPage (PageIntro only in unit 1), NotFound when shootPageView returns undefined |
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- Shoot pages (unit 1):
shootServiceId(id)(…/soorten-fotoshoots/<id>#service),shootService(shoot, site, pkg?)(Service,offersonly withpkg),breadcrumbList(items),faqPage(path, items)(undefinedwithout items),shootPageGraph(view, site)(WebPage + optional FAQPage);shootServicesbuilds the overview list withshootService
Components (props)
AppShell(),NavigationBar(),BackToTop(),NotFound()— no propsMobileNav({ id, open, groupOpen, pathname, dispatch }),NavLink(RouterLink props & { sectionCurrent? }),NavSubmenu({ item, id, open, pathname, transparent, toggleRef, dispatch })(desktop panel),MobileNavGroup({ item, id, open, pathname, dispatch }),ChevronIcon()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: InstagramContent, profileUrl })(shared,components/InstagramGrid/)ContactForm(...),ContactFormGate({ enabled, email, ... })PhotoDuo({ photos: [ContentImage, ContentImage], label, 'data-testid'? })PortfolioGrid({ items: GalleryItem[], eagerCount = 3, onOpen(index), onIntent?(), 'data-testid'? }),Lightbox({ items, index: number | null, onIndexChange, onClose, label?, finalFocusEl? })(default export, lazy-loadable),FilterBar({ options: FilterOption[], value, onChange, label })about/AboutIntro({ content }),about/StorySection({ content, titleId, tone?, spacing?, children? }),shoots/ShootList({ shoots, packages, portfolioShoots })(types that link to the portfolio),shoots/ShootBlock({ shoot, packages, reverse, priority, portfolioLink }),portfolio/PortfolioGallery({ photos, shootTypes, shoot, onShootChange })StatusPage({ title, children, actions? }),ErrorPage({ error, reset })LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })UmamiAnalytics({ hostname? })
Hooks
useHeroSlider(count)→ slider state, controls, handlers,HeroAnnouncement(swipe viauseSwipe, wrap viawrapIndex)useSwipe({ onPrev, onNext, enabled? })→{ onTouchStart, onTouchEnd }(threshold and direction fromlib/swipeDirection)useScrolledPast(getThreshold)→ boolean (stablegetThresholdrequired)useRouteFocus()— focuses<main>after navigationuseDismiss(ref, active, onDismiss(reason: 'escape' | 'outside'))— document-level Escape and outside pointer down, listeners only whileactive(unit 3)useInView({ 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- Portfolio (
lib/portfolioFilters.ts):isShootTypeId,shootTypesWithPhotos(shootTypes, photos),shootFromSearch(value, available),filterPhotos(photos, shoot),filterOptions(shootTypes, allLabel),toGalleryItems(photos, shootTypes),photoCountLabel(n);seo.ts:galleryImages(photos) - Gallery (portfolio-page):
wrapIndex(index, count),swipeDirection(start, end, threshold = 50),masonryRowSpan({ width, height }, K = 40, gapRows = 2),neighbourIndexes(index, count, radius = 2),lightboxReducer(state, event)(+LightboxState,LightboxEvent) - Shoot pages (unit 1):
shootPagePath(id),shootIdFromSlug(slug),shootIdFromPath(pathname)(lib/shootPages.ts);shootPackage(shoot, packages)(lib/shootPackage.ts);fillPlaceholders(text, values),fillRichText(rich, values)(lib/fillPlaceholders.ts);richTextToPlain(text)(lib/richTextToPlain.ts);shootPageView(id, page, sources)(lib/shootPageView.ts) - Navigation (unit 3):
shootNavItems(shoots): NavItem[](lib/shootNavItems.ts);isItemCurrent(item, pathname),isSectionCurrent(item, pathname)(lib/navCurrent.ts);navMenuReducer(state, event)withNavMenuState,NavMenuEvent,initialNavMenuState,FocusRequest(lib/navMenuState.ts)
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
InstagramContent
- Fields:
title,handle,photos: ContentImage[](the intro photos followed by the review photos,instagramContent.ts)
LinkTarget / InlineLink / RichText
- Fields:
{ to: RoutePath; hash? };InlineLinkaddstext;RichText = (string | InlineLink)[]
PortfolioContent / PortfolioPhoto
- Fields:
intro(eyebrow, title, text),photos: PortfolioPhoto[]—{ id, shootType: ShootTypeId, thumb: ContentImage (800 px wide), full: ImageSource (1600 px long side) }
GalleryItem / FilterOption
- Fields:
{ id, thumb, full, caption? }/{ id, label }(generic, for the gallery blocks)
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,children?: readonly NavItem[](one level;hasChildren(item)is true only for a non-empty list; the shoot pages are the children of/soorten-fotoshoots)
PageMeta (sitePages.ts)
- Fields:
title,description,indexed,ogImage?