Plans the Over mij page
Refreshes the reverse engineering docs after the homepage sections and records the requirements, execution plan and application design for the Over mij page: live texts in the design's structure, an indexed page with its own structured data and preview image, and shared building blocks (PageSection, MediaText, Eyebrow) reused by the homepage. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -11,7 +11,7 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
|
||||
| Path | File | Head | Component | Indexed |
|
||||
|------|------|------|-----------|---------|
|
||||
| (root) | `routes/__root.tsx` | `siteHead(siteContent)` | `AppShell` | — |
|
||||
| `/` | `routes/index.tsx` | `pageHead('/')` | `Hero` | yes |
|
||||
| `/` | `routes/index.tsx` | `pageHead('/')` | `Hero` + six home sections; search `?pakket=` | yes |
|
||||
| `/over-mij` | `routes/over-mij.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
|
||||
| `/portfolio` | `routes/portfolio.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
|
||||
| `/soorten-fotoshoots` | `routes/soorten-fotoshoots.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
|
||||
@@ -32,6 +32,13 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
|
||||
- `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, ... })`
|
||||
- `StatusPage({ title, children, actions? })`, `ErrorPage({ error, reset })`
|
||||
- `LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })`
|
||||
- `UmamiAnalytics({ hostname? })`
|
||||
@@ -40,6 +47,7 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
|
||||
- `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`
|
||||
@@ -47,13 +55,20 @@ None. There is no back-end yet (`api/` is empty). The static design README antic
|
||||
- `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`
|
||||
- **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`
|
||||
### 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
|
||||
|
||||
@@ -15,10 +15,13 @@ graph TD
|
||||
Shell --> Footer["Footer (FooterColumn, FooterLink)"]
|
||||
Shell --> ToTop["BackToTop"]
|
||||
Shell --> Umami["UmamiAnalytics"]
|
||||
Outlet --> Home["routes/index.tsx: Hero"]
|
||||
Outlet --> Home["routes/index.tsx: Hero + six sections"]
|
||||
Outlet --> Placeholders["over-mij, portfolio, soorten-fotoshoots, contact, privacyverklaring: PageIntro"]
|
||||
Home --> Hero["Hero (HeroArrows, HeroPauseButton, HeroSocials, useHeroSlider)"]
|
||||
Content["content/: siteContent, heroContent, types"] -.-> Shell
|
||||
Home --> Sections["components/home/: IntroGallery, AboutBlock, Pricing, Testimonials, ContactSection, InstagramGrid"]
|
||||
Sections --> Blocks["Shared blocks: PageSection, MediaText, Eyebrow, SectionHeading, FramedImage, DeferredImage, Reveal"]
|
||||
Sections --> Form["ContactForm + ContactFormGate (lazy), contact/"]
|
||||
Content["content/: siteContent, heroContent, homeContent, packages, testimonials, types"] -.-> Shell
|
||||
Content -.-> Home
|
||||
Nav --> NavData["navigation.ts: mainNav, footerNav"]
|
||||
Footer --> NavData
|
||||
@@ -31,11 +34,11 @@ graph TD
|
||||
classDef support fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
||||
class Main,Root entry;
|
||||
class Shell,Skip,Nav,Footer,ToTop,Umami,Outlet shell;
|
||||
class Home,Placeholders,Hero page;
|
||||
class Content,NavData,Seo,Theme support;
|
||||
class Home,Placeholders,Hero,Sections,Form page;
|
||||
class Content,NavData,Seo,Theme,Blocks support;
|
||||
```
|
||||
|
||||
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero, the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
|
||||
Text alternative: main.tsx starts Sentry and mounts the router; the root route renders AppShell (skip link, NavigationBar, the page via Outlet, Footer, BackToTop, Umami); the home route renders the Hero and six sections built from shared blocks (one of them lazily loads the contact form); the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
|
||||
|
||||
## Component Descriptions
|
||||
### main.tsx
|
||||
@@ -68,21 +71,41 @@ Text alternative: main.tsx starts Sentry and mounts the router; the root route r
|
||||
- **Responsibilities**: Crossfade slides, progress-driven autoplay, arrows, swipe, pause button, pause on hover/focus/hidden tab, reduced motion, live-region announcements, lazy loading of nearby slides, social icons
|
||||
- **Type**: Application
|
||||
|
||||
### components/home/ (homepage sections)
|
||||
- **Purpose**: The six homepage blocks below the hero, in LAYOUT.md order
|
||||
- **Responsibilities**: `IntroGallery` (four photos, swipeable row on phones), `AboutBlock` (framed photo of Andrea + intro + link to `/over-mij`), `Pricing` + `PriceCard` (packages with "Boek" links → `/?pakket=…#contact`), `Testimonials` (+ `TestimonialCarousel`, `TestimonialSlide`), `ContactSection` (lazy `ContactForm` behind `ContactFormGate`, mailto fallback), `InstagramGrid` (fixed tiles linking to the profile)
|
||||
- **Type**: Application
|
||||
|
||||
### Shared section building blocks
|
||||
- **Purpose**: Reusable pieces extracted during homepage-sections; `HomeSection` was renamed to `PageSection` and `MediaText`/`Eyebrow` were extracted in over-mij-page
|
||||
- **Responsibilities**: `PageSection` (section frame: `aria-labelledby`, tone `paper`/`alt`, width `default`/`narrow`/`full`, spacing `default`/`tight`/`flushTop`, anchor offset), `MediaText` (framed photo next to a text column, design `.about`), `Eyebrow` (accent label, optionally a heading), `SectionHeading` (eyebrow + h2 + lead, align start/center, compact spacing), `FramedImage` (photo with sand-coloured offset block, design `.about__media`), `DeferredImage` (loads after page load and near the viewport, reserves space), `Reveal` (fade-in on scroll, content always in the DOM, reduced motion respected)
|
||||
- **Type**: Application (shared UI)
|
||||
|
||||
### components/PageIntro/, StatusPage/
|
||||
- **Purpose**: Shared page building blocks
|
||||
- **Responsibilities**: `PageIntro` — eyebrow, the page's h1 and an intro (used by placeholders); `StatusPage` — layout for 404 and error pages
|
||||
- **Responsibilities**: `PageIntro` — eyebrow, the page's h1 and an intro (used by placeholders; design `.page-head`); `StatusPage` — layout for 404 and error pages
|
||||
- **Type**: Application
|
||||
|
||||
### components/ContactForm/ + contact/
|
||||
- **Purpose**: Contact form, built ahead of the API
|
||||
- **Responsibilities**: `ContactForm` (fields, validation, honeypot + minimum fill time, reducer-driven status), `ContactFormGate` (dims the form under a "coming soon" notice while `siteContent.contactForm.enabled` is false); `contact/submitContactForm.ts` (placeholder submit), `contact/types.ts` (fields, limits, payload)
|
||||
- **Type**: Application
|
||||
|
||||
### content/
|
||||
- **Purpose**: Static content until the CMS API exists
|
||||
- **Responsibilities**: `types.ts` (API-shaped interfaces), `siteContent.ts` (footer intro, socials, e-mail parts), `heroContent.ts` (title, tagline, CTA, slides), `socialPlatforms.ts` (platform → name + offline icon)
|
||||
- **Responsibilities**: `types.ts` (API-shaped interfaces incl. `ContentImage`, `HomeContent`, `PricingPackage`, `Testimonial`), `siteContent.ts` (footer intro, socials, e-mail parts, contact form switch), `heroContent.ts`, `homeContent.ts` (texts and photos of the homepage sections), `packages.ts`, `testimonials.ts`, `socialPlatforms.ts`
|
||||
- **Type**: Application (data)
|
||||
|
||||
### lib/
|
||||
- **Purpose**: Pure, fully tested helpers
|
||||
- **Responsibilities**: `emailAddress`, `visibleSocials`, `copyrightLine`, `slidesToLoad`, `backToTopThreshold`
|
||||
- **Responsibilities**: `emailAddress`, `visibleSocials`, `copyrightLine`, `slidesToLoad`, `backToTopThreshold`, `slideLabel`, `formatPrice`, `bookLabel`, `visiblePackages`, `visibleTestimonials`, `packageFromSearch`, `shootOptions`, `mailLink`, `validateContact`, `isLikelySpam`, `toContactPayload`, `contactFormReducer`
|
||||
- **Type**: Application (utility, 100% coverage threshold)
|
||||
|
||||
### hooks/
|
||||
- **Purpose**: Shared behaviour
|
||||
- **Responsibilities**: `useRouteFocus`, `useScrolledPast`, `useInView` (IntersectionObserver), `usePageLoaded` (after the load event), `useReveal` (reveal once, immediately with reduced motion)
|
||||
- **Type**: Application
|
||||
|
||||
### seo.ts, sitePages.ts, sitemap.ts
|
||||
- **Purpose**: SEO
|
||||
- **Responsibilities**: Page registry (title, description, `indexed`), `pageHead(path)`, canonical URLs, JSON-LD, sitemap generation at build time (via `config/sitemapPlugin.ts`)
|
||||
@@ -100,7 +123,7 @@ Text alternative: main.tsx starts Sentry and mounts the router; the root route r
|
||||
|
||||
### theme.ts / recipes/
|
||||
- **Purpose**: Design system
|
||||
- **Responsibilities**: Colour, font, spacing, easing, duration, z-index tokens; semantic `bg`/`fg`/`focusRing`, `header`/`content`/`pageTop` sizes; `eyebrow`/`display`/`pageTitle` text styles; recipes `container`, `link` (subtle), `linkButton` (outline/accent/light), `iconControl`, `skipNavLink`
|
||||
- **Responsibilities**: Colour (paper/ink/accent/sand/line/error), font, spacing (`gutter`, `sectionY`, `sectionYTight`, `sectionHeadGap`, `gridGap`), easing, duration (`interaction`, `fade`, `reveal`), z-index, shadow, gradient tokens; semantic `bg`/`fg`/`focusRing`, `header`/`content`/`contentNarrow` sizes, `header`/`pageTop` spacing; text styles `eyebrow`/`display`/`sectionTitle`/`lead`/`pageTitle`; recipes `container`, `link` (subtle/underline), `linkButton` (outline/accent/light, size default/fit), `iconControl`, `carouselControl`, `formControl`, `skipNavLink`
|
||||
- **Type**: Application (shared UI foundation)
|
||||
|
||||
## Data Flow
|
||||
@@ -125,7 +148,7 @@ sequenceDiagram
|
||||
Text alternative: a visitor navigates, the router renders the root layout (AppShell), which renders the matched page through the Outlet; the page's head() supplies title/meta from the page registry and focus moves to main.
|
||||
|
||||
## Integration Points
|
||||
- **External APIs**: None yet (planned .NET API for content and the contact form — design README: `POST /api/contact` with `{ naam, email, onderwerp, bericht }`)
|
||||
- **External APIs**: None yet (planned .NET API for content and the contact form; the form already sends `{ naam, email, shoot, bericht }` to a placeholder `submitContactForm` and stays gated off until the API exists)
|
||||
- **Databases**: None
|
||||
- **Third-party Services**: Sentry (errors, EU ingest), Umami at analytics.slpsoftware.nl (cookieless stats), UptimeRobot (availability, external), outbound links to Facebook/Instagram
|
||||
|
||||
|
||||
@@ -27,14 +27,16 @@ Text alternative: visitors and crawlers use the website, which links out to soci
|
||||
## Business Description
|
||||
- **Business Description**: Portfolio and marketing website for Andrea Slop Fotografie, a lifestyle photographer in Huizen (NL). It presents her work (loveshoots, family, pregnancy and newborn shoots), tells who she is, lists shoot types and prices, and gets prospective clients to make contact. It will replace the existing WordPress (Solene theme) site at andreaslop.nl; a test build runs at test.andreaslop.nl.
|
||||
- **Business Transactions** (current state — front-end only, no back-end):
|
||||
- **Browse the homepage** — hero slider with featured photos (autoplay, arrows, swipe, pause button, screen reader announcements), call-to-action to "Over mij"
|
||||
- **Browse the homepage** — hero slider with featured photos (autoplay, arrows, swipe, pause button, screen reader announcements), call-to-action to "Over mij"; below it Lifestyle fotografie (photo gallery), Over mij (intro + "Lees mijn verhaal" → `/over-mij`), Prijzen (packages), Lieve woorden (testimonials carousel), Contact and Instagram
|
||||
- **Choose a package** — "Boek" on a price card scrolls to Contact with that shoot preselected (`?pakket=`)
|
||||
- **Contact the photographer** — contact form (validation, anti-spam) shown dimmed under a "coming soon" notice until the API exists; mailto fallback with a subject
|
||||
- **Navigate between pages** — header navigation (desktop), full-screen menu (mobile), footer menu, skip link, back-to-top button
|
||||
- **Visit social profiles** — Facebook / Instagram links in the hero and footer
|
||||
- **E-mail the photographer** — mailto link in the footer
|
||||
- **Share / discover pages** — per-page title, description, canonical URL, Open Graph tags, JSON-LD (ProfessionalService), sitemap.xml, robots.txt
|
||||
- **Recover from errors** — 404 page inside the shell, error page with retry
|
||||
- *Placeholder pages (noindex)*: Over mij, Portfolio, Soorten fotoshoots, Contact, Privacyverklaring
|
||||
- *Planned (static design only)*: homepage sections below the hero (lifestyle gallery, about, prices, contact form, Instagram), portfolio with lightbox, shoot types and pricing page, contact page
|
||||
- *Planned (static design only)*: Over mij page (intro with portrait, "Hoe het begon", photo duo, "Buiten de camera om", booking button), portfolio with lightbox, shoot types and pricing page, contact page
|
||||
- **Business Dictionary**:
|
||||
- **Shell** — the Header / page content / Footer frame shared by every page (see LAYOUT.md)
|
||||
- **Hero** — full-screen photo slider at the top of the homepage
|
||||
@@ -48,7 +50,7 @@ Text alternative: visitors and crawlers use the website, which links out to soci
|
||||
## Component Level Business Descriptions
|
||||
### web (React front-end)
|
||||
- **Purpose**: The public website visitors see
|
||||
- **Responsibilities**: Page routing, layout shell, homepage hero, SEO, monitoring, design system, server configuration for test (nginx) and production (IIS)
|
||||
- **Responsibilities**: Page routing, layout shell, homepage (hero + six sections, contact form behind a gate), SEO, monitoring, design system, server configuration for test (nginx) and production (IIS)
|
||||
|
||||
### .gitea/workflows (CI/CD)
|
||||
- **Purpose**: Quality gate and delivery
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
## Test Coverage
|
||||
- **Overall**: Good. Vitest with v8 coverage; 100% threshold enforced for `src/lib/**`, `src/seo.ts`, `src/sitemap.ts`; other files reported
|
||||
- **Unit Tests**: Pure helpers, SEO, sitemap, monitoring config, security headers, server config (incl. drift check against `deploy/`)
|
||||
- **Component Tests**: AppShell, NavigationBar, Footer, Hero (+ slider hook), BackToTop, PageIntro, StatusPage, Umami — with axe accessibility checks
|
||||
- **Component Tests**: AppShell, NavigationBar, Footer, Hero (+ slider hook), BackToTop, PageIntro, StatusPage, Umami, all home sections, PageSection, MediaText, Eyebrow, SectionHeading, FramedImage, DeferredImage, Reveal, ContactForm(+Gate) — with axe accessibility checks; `app.test.tsx` renders whole routes
|
||||
- **Property-based Tests**: fast-check, shared arbitraries in `src/test/arbitraries.ts`, seed logged in CI
|
||||
- **Integration / E2E**: No browser E2E; Lighthouse CI covers built pages (accessibility, best practices, SEO, performance)
|
||||
|
||||
@@ -15,8 +15,9 @@
|
||||
## Technical Debt
|
||||
- Homepage mobile Lighthouse performance target is lowered to 0.8 (images not responsive, title after JavaScript); back to 0.9 is planned with responsive images from the API and prerendering
|
||||
- Five routes are placeholders (`noindex`); `lighthouserc.cjs` keeps its own list of indexed/noindex paths, guarded by a test against `sitePages.ts`
|
||||
- Static design images for the homepage sections (intro gallery, about photo, pricing decorations) are not yet in `web/src/assets`
|
||||
- No responsive image pipeline (srcset/sizes); hero photos are single large JPEGs
|
||||
- No responsive image pipeline (srcset/sizes); photos are single JPEGs
|
||||
- Comment language is mixed: older code is commented in Dutch, homepage-sections code in English
|
||||
- Over mij page images (`andrea-portret.jpg`, `about-1.jpg`, `about-2.jpg`) exist only in the static design, not yet in `web/src/assets`
|
||||
|
||||
## Patterns and Anti-patterns
|
||||
- **Good Patterns**: API-shaped content; pure, property-tested helpers; tokens and recipes as single source of truth; configuration as code for headers; strong accessibility baseline (axe in tests, Lighthouse accessibility 1.0)
|
||||
|
||||
@@ -31,45 +31,61 @@ graph TD
|
||||
Hero --> useHeroSlider["Hero/useHeroSlider.ts"]
|
||||
Hero --> LinkButton["components/LinkButton.tsx"]
|
||||
LinkButton --> RouterLink["components/RouterLink.tsx"]
|
||||
Placeholder["routes/contact.tsx and other placeholders"] --> PageIntro["PageIntro/PageIntro.tsx"]
|
||||
Index --> HomeParts["home/*: IntroGallery, AboutBlock, Pricing, Testimonials, ContactSection, InstagramGrid"]
|
||||
HomeParts --> PageSection["PageSection/PageSection.tsx"]
|
||||
HomeParts --> SectionHeading["SectionHeading/SectionHeading.tsx"]
|
||||
HomeParts --> Reveal["Reveal/Reveal.tsx"]
|
||||
HomeParts --> FramedImage["FramedImage/FramedImage.tsx"]
|
||||
FramedImage --> DeferredImage["DeferredImage/DeferredImage.tsx"]
|
||||
HomeParts --> DeferredImage
|
||||
Placeholder["routes/over-mij.tsx and other placeholders"] --> PageIntro["PageIntro/PageIntro.tsx"]
|
||||
classDef shell fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
|
||||
classDef page fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
|
||||
classDef util fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
||||
class Root,AppShell,NavigationBar,Footer,BackToTop,Umami,NavLink,MobileNav shell;
|
||||
class Index,Hero,HeroArrows,HeroPause,HeroSocials,Placeholder,PageIntro page;
|
||||
class navigation,useHeroSlider,LinkButton,RouterLink util;
|
||||
class Index,Hero,HeroArrows,HeroPause,HeroSocials,Placeholder,PageIntro,HomeParts page;
|
||||
class navigation,useHeroSlider,LinkButton,RouterLink,PageSection,SectionHeading,Reveal,FramedImage,DeferredImage util;
|
||||
```
|
||||
|
||||
Text alternative: the root route renders AppShell (NavigationBar, Footer, BackToTop, Umami); NavigationBar and Footer read navigation.ts; the index route renders the Hero with its sub-components and LinkButton; placeholder routes render PageIntro.
|
||||
Text alternative: the root route renders AppShell (NavigationBar, Footer, BackToTop, Umami); NavigationBar and Footer read navigation.ts; the index route renders the Hero and the six home sections, which are built from the shared PageSection, SectionHeading, Reveal, FramedImage and DeferredImage blocks; placeholder routes render PageIntro.
|
||||
|
||||
### Existing Files Inventory
|
||||
Candidates for modification are marked with ★ for the homepage-sections feature.
|
||||
Candidates for modification are marked with ★ for the over-mij-page feature.
|
||||
- `web/index.html` — HTML entry; static fallback head for non-JS crawlers
|
||||
- `web/src/main.tsx` — bootstrap
|
||||
- `web/src/routeTree.gen.ts` — generated (do not edit)
|
||||
- `web/src/routes/__root.tsx` — root layout, site head, 404/error
|
||||
- ★ `web/src/routes/index.tsx` — home (`/`), currently only the Hero
|
||||
- `web/src/routes/{over-mij,portfolio,soorten-fotoshoots,contact,privacyverklaring}.tsx` — placeholders with `PageIntro`
|
||||
- `web/src/routes/index.tsx` — home (`/`): Hero + six sections, `?pakket=` search param
|
||||
- ★ `web/src/routes/over-mij.tsx` — placeholder with `PageIntro` (to become the real page)
|
||||
- `web/src/routes/{portfolio,soorten-fotoshoots,contact,privacyverklaring}.tsx` — placeholders with `PageIntro`
|
||||
- `web/src/components/AppShell.tsx` — shell
|
||||
- `web/src/components/NavigationBar/*` — header, NavLink, MobileNav
|
||||
- `web/src/components/Footer/*` — footer, FooterColumn, FooterLink
|
||||
- `web/src/components/Hero/*` — hero slider, arrows, pause button, socials, slider hook
|
||||
- `web/src/components/home/*` — the six homepage sections (AboutBlock is the closest relative of the Over mij page's first block)
|
||||
- ★ `web/src/components/PageSection/PageSection.tsx` — section frame for any page (was `HomeSection`)
|
||||
- ★ `web/src/components/MediaText/MediaText.tsx`, `Eyebrow/Eyebrow.tsx` — framed photo next to text; accent label
|
||||
- ★ `web/src/components/SectionHeading/SectionHeading.tsx` — eyebrow + h2 + lead
|
||||
- ★ `web/src/components/FramedImage/FramedImage.tsx`, `DeferredImage/DeferredImage.tsx`, `Reveal/Reveal.tsx` — photo blocks and fade-in
|
||||
- `web/src/components/ContactForm/*` — contact form and gate
|
||||
- `web/src/components/BackToTop/BackToTop.tsx` — back-to-top button
|
||||
- `web/src/components/Analytics/UmamiAnalytics.tsx` — Umami script injection
|
||||
- `web/src/components/PageIntro/PageIntro.tsx` — page head block (eyebrow, h1, intro)
|
||||
- ★ `web/src/components/PageIntro/PageIntro.tsx` — page head block (eyebrow, h1, intro)
|
||||
- `web/src/components/StatusPage/*` — StatusPage layout, NotFound, ErrorPage
|
||||
- `web/src/components/LinkButton.tsx`, `RouterLink.tsx` — router links (button style / Chakra-wrapped)
|
||||
- ★ `web/src/components/LinkButton.tsx`, `RouterLink.tsx` — router links (button style / Chakra-wrapped)
|
||||
- ★ `web/src/content/types.ts` — content interfaces (API shape)
|
||||
- ★ `web/src/content/siteContent.ts`, `heroContent.ts`, `socialPlatforms.ts` — static content
|
||||
- `web/src/hooks/useRouteFocus.ts`, `useScrolledPast.tsx`
|
||||
- ★ `web/src/content/*.ts` — static content (`siteContent`, `heroContent`, `homeContent`, `packages`, `testimonials`, `socialPlatforms`)
|
||||
- `web/src/contact/*` — contact form types and placeholder submit
|
||||
- `web/src/hooks/*` — `useRouteFocus`, `useScrolledPast`, `useInView`, `usePageLoaded`, `useReveal`
|
||||
- `web/src/lib/*.ts` — pure helpers with tests
|
||||
- `web/src/monitoring/*` — Sentry/Umami config and loader
|
||||
- `web/src/navigation.ts` — `RoutePath`, `mainNav`, `footerNav`
|
||||
- ★ `web/src/seo.ts`, `sitePages.ts`, `sitemap.ts` — SEO (home description may change)
|
||||
- ★ `web/src/seo.ts`, `sitePages.ts`, `sitemap.ts` — SEO (`/over-mij` is `indexed: false` today)
|
||||
- ★ `web/lighthouserc.cjs` / `.desktop.cjs` — own list of indexed/noindex paths, guarded by a test
|
||||
- `web/src/theme.ts`, `web/src/recipes/*.ts` — design system
|
||||
- `web/src/test/*` — `renderWithProviders`, axe matcher, fast-check arbitraries, setup
|
||||
- `web/src/assets/*` — hero photos (8), light/dark logos
|
||||
- ★ `web/config/securityHeaders.ts` — CSP (only if the contact form posts to a third party)
|
||||
- `web/src/test/*` — `renderWithProviders`, axe matcher, fast-check arbitraries, `fakeIntersectionObserver`, setup
|
||||
- `web/src/assets/*` — hero photos (8), `home/` (intro 1–4, andrea, deco 1–2, two review photos), light/dark logos
|
||||
- `web/config/securityHeaders.ts` — CSP
|
||||
- `web/config/serverConfig.ts`, `writeServerConfig.ts`, `sitemapPlugin.ts`, `testSeed.ts`
|
||||
- `web/deploy/iis/web.config`, `web/deploy/nginx/*.conf` — generated server configs
|
||||
- `web/public/*` — favicon, logo, og-image, robots.txt, icons.svg
|
||||
@@ -90,6 +106,15 @@ Candidates for modification are marked with ★ for the homepage-sections featur
|
||||
- **Purpose**: Single source for colours, fonts, spacing, motion; reusable component variants
|
||||
- **Implementation**: `defineConfig` tokens/semanticTokens/textStyles, `defineRecipe` + `useRecipe`
|
||||
|
||||
### Section composition
|
||||
- **Location**: `components/home/*` on top of `PageSection`, `MediaText`, `SectionHeading`, `Reveal`, `FramedImage`, `DeferredImage`
|
||||
- **Purpose**: Each section is a thin component that gets its content as a prop and composes the shared blocks; the h2 id links the section landmark (`aria-labelledby`)
|
||||
- **Implementation**: One `TITLE_ID` constant per section; `data-testid` on the section root; validity filters in `lib/` (e.g. `visiblePackages`) decide what is rendered
|
||||
|
||||
### Deferred below-the-fold images
|
||||
- **Location**: `DeferredImage`, `usePageLoaded`, `useInView`
|
||||
- **Purpose**: Protect the largest contentful paint; photos load only after the load event and near the viewport, with intrinsic width/height reserving space
|
||||
|
||||
### Page registry
|
||||
- **Location**: `sitePages.ts`, typed by `RoutePath`
|
||||
- **Purpose**: One source for head tags and the sitemap; `indexed: false` for placeholders
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
- `web/config/` + `web/deploy/` — security headers and generated nginx (test) / IIS (production) configuration
|
||||
|
||||
## Shared Packages
|
||||
- None as separate packages. Inside `web`: `theme.ts`, `recipes/`, `content/`, `lib/`, `seo.ts`, `navigation.ts`, `hooks/`, `components/LinkButton.tsx`, `components/RouterLink.tsx`, `components/PageIntro/`
|
||||
- None as separate packages. Inside `web`: `theme.ts`, `recipes/`, `content/`, `lib/`, `seo.ts`, `navigation.ts`, `hooks/`, `components/LinkButton.tsx`, `components/RouterLink.tsx`, `components/PageIntro/`, and the section blocks `PageSection`, `MediaText`, `Eyebrow`, `SectionHeading`, `FramedImage`, `DeferredImage`, `Reveal`
|
||||
|
||||
## Test Packages
|
||||
- None as separate packages. Tests are co-located (`*.test.ts(x)`) and run with Vitest (unit, component, property-based with fast-check, accessibility with axe-core); Lighthouse CI for quality budgets
|
||||
|
||||
@@ -14,17 +14,18 @@ graph LR
|
||||
components --> hooks["hooks/*"]
|
||||
components --> navigation["navigation.ts"]
|
||||
components --> assets["assets/*"]
|
||||
components --> contact["contact/*"]
|
||||
config["config/* (Node, build time)"] --> monitoring
|
||||
config --> seo
|
||||
classDef app fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
|
||||
classDef support fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
||||
classDef build fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
|
||||
class main,routes,components app;
|
||||
class theme,monitoring,content,seo,lib,hooks,navigation,assets support;
|
||||
class theme,monitoring,content,seo,lib,hooks,navigation,assets,contact support;
|
||||
class config build;
|
||||
```
|
||||
|
||||
Text alternative: main depends on theme, routes and monitoring; routes depend on components, content and SEO; components depend on lib, hooks, navigation and assets; build-time config reads monitoring (CSP origins) and SEO (sitemap).
|
||||
Text alternative: main depends on theme, routes and monitoring; routes depend on components, content and SEO; components depend on lib, hooks, navigation, assets and the contact form module; build-time config reads monitoring (CSP origins) and SEO (sitemap).
|
||||
|
||||
### routes depend on content and components
|
||||
- **Type**: Compile
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
# Reverse Engineering Metadata
|
||||
|
||||
**Analysis Date**: 2026-10-19T19:19:38Z (refresh; previous analysis 2026-10-14T09:58:04Z at 8f5841c)
|
||||
**Analysis Date**: 2026-10-22T16:58:52Z (refresh; previous analysis 2026-10-19T19:19:38Z at 38c5c3e)
|
||||
**Analyzer**: AI-DLC
|
||||
**Workspace**: K:\Development\SlpSoftware\Projects\AndreaSlopFotografie
|
||||
**Codebase Commit**: 38c5c3e (branch master)
|
||||
**Total Files Analyzed**: ~95 (web/src, web/config, web/deploy, web config files, CI workflow, design/andreaslop-static pages and README)
|
||||
**Refreshed for**: feature homepage-sections
|
||||
**Codebase Commit**: 99d4610 (branch master)
|
||||
**Total Files Analyzed**: ~95 changed files since the previous analysis (homepage sections, shared section blocks, contact form, lib helpers, hooks, recipes, theme) plus design/andreaslop-static/over-mij.html
|
||||
**Refreshed for**: feature over-mij-page
|
||||
|
||||
## Artifacts Generated
|
||||
- [x] business-overview.md
|
||||
@@ -13,6 +13,6 @@
|
||||
- [x] code-structure.md
|
||||
- [x] api-documentation.md
|
||||
- [x] component-inventory.md
|
||||
- [x] technology-stack.md
|
||||
- [x] technology-stack.md (unchanged: no dependency changes since 38c5c3e)
|
||||
- [x] dependencies.md
|
||||
- [x] code-quality-assessment.md
|
||||
|
||||
Reference in New Issue
Block a user