Replaces the placeholder with the page from the design and the texts from the live site: Andrea's introduction with her portrait, how it started, two photos, life outside photography and a booking button. The page is now indexed, with its own title, description, preview image and AboutPage data about Andrea. The portrait loads straight away instead of after the page, since on phones it is the largest paint. Lighthouse no longer lets every indexed page use the homepage's lower mobile performance target; it now only applies to the homepage itself. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
89 lines
6.1 KiB
Markdown
89 lines
6.1 KiB
Markdown
# 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, payload `{ naam, email, onderwerp, bericht }` (maps to a C# `ContactRequest` record)
|
||
- `/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(...)` | `PageIntro` placeholder | no |
|
||
| `/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 `@id` `businessId` and `founder` → `personId`), `person(content, site, image)`, `aboutPage(path, content, site)`
|
||
- `sitePages: Record<RoutePath, PageMeta>`, `pageList(pages)`
|
||
- `sitemapXml(...)` — used by `config/sitemapPlugin.ts`
|
||
|
||
### Components (props)
|
||
- `AppShell()`, `NavigationBar()`, `BackToTop()`, `NotFound()` — no props
|
||
- `MobileNav({ 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 h1
|
||
- `PageSection({ labelledBy, id?, tone?: 'paper' | 'alt', width?: 'default' | 'narrow' | 'full', spacing?: 'default' | 'tight' | 'flushTop', 'data-testid'?, children })` (was `HomeSection`)
|
||
- `MediaText({ image, aspectRatio, 'data-testid'?, children })` — framed photo next to a text column
|
||
- `Eyebrow(TextProps & { as?: 'p' | 'span' | 'h2' | 'h3' | 'h4' })` — accent label, optionally a heading
|
||
- `SectionHeading({ id, title, eyebrow?, lead?, align?: 'center' | 'start', spacing?: 'default' | 'compact', focusable? })` — renders an h2
|
||
- `FramedImage({ 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? })`, `about/RichParagraph({ paragraph: RichText })`
|
||
- `StatusPage({ title, children, actions? })`, `ErrorPage({ error, reset })`
|
||
- `LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })`
|
||
- `UmamiAnalytics({ hostname? })`
|
||
|
||
### Hooks
|
||
- `useHeroSlider(count)` → slider state, controls, handlers, `HeroAnnouncement`
|
||
- `useScrolledPast(getThreshold)` → boolean (stable `getThreshold` required)
|
||
- `useRouteFocus()` — focuses `<main>` after navigation
|
||
- `useInView({ rootMargin, skip })` → `{ ref, inView }`; `usePageLoaded()` → boolean; `useReveal()` → `{ ref, visible }`
|
||
|
||
### Pure helpers (`lib/`)
|
||
- `emailAddress({ user, domain }): string | null`
|
||
- `visibleSocials(socials): SocialLink[]` — only valid https links
|
||
- `copyrightLine(year): string`
|
||
- `slidesToLoad(active, count): number[]`
|
||
- `backToTopThreshold(viewportHeight): number`
|
||
- `slideLabel`, `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? }`; `InlineLink` adds `text`; `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 `href` is 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?`
|