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>
This commit is contained in:
@@ -1,42 +1,67 @@
|
||||
# API Documentation
|
||||
|
||||
## REST APIs
|
||||
None. The project has no back-end yet. The static design README anticipates these future endpoints on a .NET API:
|
||||
- `POST /api/contact` — contact form, payload `{ naam, email, onderwerp, bericht }`
|
||||
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 |
|
||||
|------|------|------|-----------|
|
||||
| (root) | `routes/__root.tsx` | `siteHead` | `AppShell` via `RootLayout` |
|
||||
| `/` | `routes/index.tsx` | `pageHead(...)` | `Hero` |
|
||||
| `/over-mij` | `routes/over-mij.tsx` | `pageHead(...)` | placeholder |
|
||||
| Path | File | Head | Component | Indexed |
|
||||
|------|------|------|-----------|---------|
|
||||
| (root) | `routes/__root.tsx` | `siteHead(siteContent)` | `AppShell` | — |
|
||||
| `/` | `routes/index.tsx` | `pageHead('/')` | `Hero` | 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 |
|
||||
| `/contact` | `routes/contact.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
|
||||
| `/privacyverklaring` | `routes/privacyverklaring.tsx` | `pageHead(...)` | `PageIntro` placeholder | no |
|
||||
| (not found) | — | — | `NotFound` | — |
|
||||
|
||||
### seo.ts
|
||||
- **Methods**: `pageHead({ title: string, description: string })` → `{ meta: [...] }`; `siteHead` constant
|
||||
- **Return Types**: TanStack Router `head` option object (title, description, og:title, og:description)
|
||||
### 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)`, `professionalService(content)`
|
||||
- `sitePages: Record<RoutePath, PageMeta>`, `pageList(pages)`
|
||||
- `sitemapXml(...)` — used by `config/sitemapPlugin.ts`
|
||||
|
||||
### Components (props)
|
||||
- `AppShell()` — no props
|
||||
- `NavigationBar()` — no props; reads route via `useRouterState`, scroll via `useScrolledPast`
|
||||
- `NavLink(props: ComponentProps<ChakraLink>)`
|
||||
- `MobileNav({ id: string, open: boolean, onClose: () => void })`
|
||||
- `Footer()` — no props
|
||||
- `LinkButton(props: ChakraLink props & { variant?: 'outline' | 'accent' | 'light' })`
|
||||
- `Hero({ content: HeroContent })`, `HeroArrows({ onPrev, onNext })`, `HeroSocials({ socials: HeroSocial[] })`
|
||||
- `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
|
||||
- `StatusPage({ title, children, actions? })`, `ErrorPage({ error, reset })`
|
||||
- `LinkButton(RouterLink props & { variant?: 'outline' | 'accent' | 'light' })`
|
||||
- `UmamiAnalytics({ hostname? })`
|
||||
|
||||
### Hooks
|
||||
- `useScrolledPast(getThreshold: () => number): boolean` — `getThreshold` must be referentially stable (it is an effect dependency)
|
||||
- `useHeroSlider(count: number)` → `{ active, reducedMotion, autoplay, paused, next, prev, handlers }`
|
||||
- `useHeroSlider(count)` → slider state, controls, handlers, `HeroAnnouncement`
|
||||
- `useScrolledPast(getThreshold)` → boolean (stable `getThreshold` required)
|
||||
- `useRouteFocus()` — focuses `<main>` after navigation
|
||||
|
||||
### 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`
|
||||
|
||||
### Monitoring
|
||||
- `monitoringFor(hostname): Monitoring | null`, `startSentry(hostname?)`, `reportError(error)`
|
||||
|
||||
## Data Models
|
||||
### NavItem (`navItems.ts`)
|
||||
- **Fields**: `to` (route path), `label` (Dutch menu label)
|
||||
- **Validation**: `as const` — `to` must be a registered route for type-safe `Link`
|
||||
|
||||
### HeroContent (`Hero/types.ts`)
|
||||
- **Fields**: `title`, `tagline`, `cta: { label, to }`, `slides: { id, src, alt }[]`, `socials: { platform, href }[]`
|
||||
- **Relationships**: `HeroSocial.platform` is a `SocialPlatform` key from `socialPlatforms.ts`
|
||||
- **Validation**: empty `href` → social not shown
|
||||
### SiteContent (`content/types.ts`)
|
||||
- **Fields**: `footerIntro: string`, `socials: SocialLink[]`, `email: EmailAddress`
|
||||
### 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?`
|
||||
|
||||
@@ -1,79 +1,107 @@
|
||||
# System Architecture
|
||||
|
||||
## System Overview
|
||||
A single client-side React SPA (`web/`) built with Vite. Routing is file-based via TanStack Router; styling uses Chakra UI v3 with a custom theme system (tokens taken from the static design). There is no back-end, API, database or deployment pipeline yet; the README states a .NET API is planned. Content is currently hard-coded in TypeScript modules shaped so they can later come from that API.
|
||||
A single client-side React SPA (`web/`) built with Vite. Routing is file-based via TanStack Router; styling uses Chakra UI v3 with a custom system (tokens from the static design). There is no back-end, API or database; `api/` is an empty placeholder for the planned .NET API. Content lives in typed TypeScript modules under `web/src/content/`, shaped so the API can later deliver it 1-to-1. One build serves both environments; the hostname decides whether monitoring is active.
|
||||
|
||||
## Architecture Diagram
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
Main["main.tsx: ChakraProvider + ThemeProvider + RouterProvider"] --> Root["routes/__root.tsx: HeadContent + AppShell + Devtools"]
|
||||
Main["main.tsx: Sentry start, router, ChakraProvider"] --> Root["routes/__root.tsx: HeadContent, AppShell, 404 and error components"]
|
||||
Root --> Shell["components/AppShell.tsx"]
|
||||
Shell --> Nav["NavigationBar (+ NavLink, MobileNav, navItems)"]
|
||||
Shell --> Skip["SkipNavLink and main landmark"]
|
||||
Shell --> Nav["NavigationBar (NavLink, MobileNav)"]
|
||||
Shell --> Outlet["Outlet (active page route)"]
|
||||
Shell --> Footer["Footer (placeholder)"]
|
||||
Shell --> Footer["Footer (FooterColumn, FooterLink)"]
|
||||
Shell --> ToTop["BackToTop"]
|
||||
Shell --> Umami["UmamiAnalytics"]
|
||||
Outlet --> Home["routes/index.tsx: Hero"]
|
||||
Outlet --> About["routes/over-mij.tsx: placeholder"]
|
||||
Home --> Hero["Hero (+ HeroArrows, HeroSocials, useHeroSlider)"]
|
||||
Hero --> Content["heroContent.ts (static content)"]
|
||||
Nav --> Scroll["hooks/useScrolledPast"]
|
||||
Theme["theme.ts + recipes/linkButton.ts"] -.-> Main
|
||||
Seo["seo.ts: pageHead / siteHead"] -.-> Root
|
||||
Outlet --> Placeholders["over-mij, portfolio, soorten-fotoshoots, contact, privacyverklaring: PageIntro"]
|
||||
Home --> Hero["Hero (HeroArrows, HeroPauseButton, HeroSocials, useHeroSlider)"]
|
||||
Content["content/: siteContent, heroContent, types"] -.-> Shell
|
||||
Content -.-> Home
|
||||
Nav --> NavData["navigation.ts: mainNav, footerNav"]
|
||||
Footer --> NavData
|
||||
Seo["seo.ts + sitePages.ts"] -.-> Root
|
||||
Seo -.-> Home
|
||||
Theme["theme.ts + recipes/"] -.-> Main
|
||||
classDef entry fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
|
||||
classDef shell fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
|
||||
classDef page fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
|
||||
classDef support fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,color:#000;
|
||||
class Main,Root entry;
|
||||
class Shell,Nav,Footer,Outlet shell;
|
||||
class Home,About,Hero page;
|
||||
class Content,Scroll,Theme,Seo support;
|
||||
class Shell,Skip,Nav,Footer,ToTop,Umami,Outlet shell;
|
||||
class Home,Placeholders,Hero page;
|
||||
class Content,NavData,Seo,Theme support;
|
||||
```
|
||||
|
||||
Text alternative: main.tsx mounts providers and the router; the root route renders AppShell (NavigationBar, the active page via Outlet, Footer); the home route renders the Hero; theme and SEO helpers 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, the other routes render placeholder PageIntros; content, navigation, SEO and theme modules support all of it.
|
||||
|
||||
## Component Descriptions
|
||||
### main.tsx
|
||||
- **Purpose**: Application bootstrap
|
||||
- **Responsibilities**: Creates the router, registers types, mounts ChakraProvider (custom system), next-themes ThemeProvider (light only), loads self-hosted fonts, removes static fallback head tags
|
||||
- **Dependencies**: routeTree.gen.ts, theme.ts
|
||||
- **Responsibilities**: Starts Sentry (deferred), creates the router (scroll restoration, default error component), mounts ChakraProvider (light only), loads self-hosted fonts, removes static fallback head tags
|
||||
- **Type**: Application
|
||||
|
||||
### routes/__root.tsx
|
||||
- **Purpose**: Root route / layout
|
||||
- **Responsibilities**: Site-wide head tags (`siteHead`), renders `HeadContent`, `AppShell` and router devtools
|
||||
- **Dependencies**: AppShell, seo.ts
|
||||
- **Responsibilities**: Site-wide head (`siteHead`: OG basics + JSON-LD), `HeadContent`, `AppShell`, dev-only router devtools, `NotFound` and `ErrorPage`
|
||||
- **Type**: Application
|
||||
|
||||
### components/AppShell.tsx
|
||||
- **Purpose**: Application shell
|
||||
- **Responsibilities**: Renders NavigationBar, `<Outlet />`, Footer. No `<main>` landmark, skip link or to-top button yet
|
||||
- **Purpose**: Application shell (LAYOUT.md "Shell")
|
||||
- **Responsibilities**: Skip link + `<main id="main">`, NavigationBar, Outlet, Footer, BackToTop, UmamiAnalytics; moves focus to main on route change (`useRouteFocus`)
|
||||
- **Type**: Application
|
||||
|
||||
### components/NavigationBar/
|
||||
- **Purpose**: Site header and navigation
|
||||
- **Responsibilities**: Fixed header; transparent over the hero on desktop on `/` until scrolled 150px; shrinks after scroll (desktop); swaps dark/light logo; desktop link list with animated underline (`NavLink`); hamburger button and full-screen `MobileNav` below `lg` (Escape to close, body scroll lock, clip-path reveal). `navItems.ts` is the single menu source (currently Home, Over mij)
|
||||
- **Responsibilities**: Fixed header, transparent over the hero on desktop until scrolled; shrinks after scroll; logo links home; desktop links and full-screen mobile menu from `mainNav`
|
||||
- **Type**: Application
|
||||
|
||||
### components/Footer.tsx
|
||||
### components/Footer/
|
||||
- **Purpose**: Site footer
|
||||
- **Responsibilities**: Placeholder copyright line only; uses Tailwind-style `className`s that have no effect (Tailwind is not installed)
|
||||
- **Responsibilities**: Logo + intro text, Socials column, Contact column (e-mail assembled in the browser), copyright line, footer menu from `footerNav`; empty columns are omitted
|
||||
- **Type**: Application
|
||||
|
||||
### components/Hero/
|
||||
- **Purpose**: Homepage hero slider
|
||||
- **Responsibilities**: Crossfade slides with zoom, progress bar driven autoplay, arrows, swipe, pause on hover/focus/hidden tab, reduced-motion support, social icons. Content typed in `types.ts` for future API use; `socialPlatforms.ts` maps platform keys to offline Iconify icons
|
||||
- **Purpose**: Homepage hero slider (the only homepage section so far)
|
||||
- **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
|
||||
|
||||
### theme.ts / recipes/linkButton.ts
|
||||
- **Purpose**: Design system
|
||||
- **Responsibilities**: Colour, font, spacing, easing, duration tokens; semantic `bg`/`fg`, `header` size tokens; `eyebrow`/`display` text styles; `linkButton` recipe (outline / accent / light)
|
||||
- **Type**: Application (shared UI foundation)
|
||||
### 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
|
||||
- **Type**: Application
|
||||
|
||||
### seo.ts
|
||||
- **Purpose**: Head tag helpers
|
||||
- **Responsibilities**: `pageHead({title, description})` for route `head` options; `siteHead` for site-wide Open Graph tags
|
||||
- **Type**: Application (utility)
|
||||
### 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)
|
||||
- **Type**: Application (data)
|
||||
|
||||
### lib/
|
||||
- **Purpose**: Pure, fully tested helpers
|
||||
- **Responsibilities**: `emailAddress`, `visibleSocials`, `copyrightLine`, `slidesToLoad`, `backToTopThreshold`
|
||||
- **Type**: Application (utility, 100% coverage threshold)
|
||||
|
||||
### 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`)
|
||||
- **Type**: Application (utility, 100% coverage threshold)
|
||||
|
||||
### monitoring/
|
||||
- **Purpose**: Error reporting and analytics configuration
|
||||
- **Responsibilities**: Hostname → environment map, Sentry DSN and origins; Sentry loaded after the load event with a queue
|
||||
- **Type**: Application
|
||||
|
||||
### config/ (build-time, Node)
|
||||
- **Purpose**: Server configuration as code
|
||||
- **Responsibilities**: `securityHeaders.ts` (CSP + headers for dev/preview/prod), `serverConfig.ts` (generates `deploy/iis/web.config` and nginx confs; a test checks they are in sync), sitemap plugin, test seed
|
||||
- **Type**: Infrastructure-as-code (small)
|
||||
|
||||
### 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`
|
||||
- **Type**: Application (shared UI foundation)
|
||||
|
||||
## Data Flow
|
||||
|
||||
@@ -90,18 +118,19 @@ sequenceDiagram
|
||||
V->>R: Open URL or click nav link
|
||||
R->>S: Render root layout
|
||||
S->>P: Render matched route via Outlet
|
||||
P-->>R: head() title and meta
|
||||
R-->>V: Updated page and head tags
|
||||
P-->>R: head() title and meta from sitePages
|
||||
R-->>V: Updated page, head tags, focus on main
|
||||
```
|
||||
|
||||
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 tags.
|
||||
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 contact form)
|
||||
- **External APIs**: None yet (planned .NET API for content and the contact form — design README: `POST /api/contact` with `{ naam, email, onderwerp, bericht }`)
|
||||
- **Databases**: None
|
||||
- **Third-party Services**: Outbound links only — Facebook, Instagram profiles
|
||||
- **Third-party Services**: Sentry (errors, EU ingest), Umami at analytics.slpsoftware.nl (cookieless stats), UptimeRobot (availability, external), outbound links to Facebook/Instagram
|
||||
|
||||
## Infrastructure Components
|
||||
- **CDK Stacks**: None
|
||||
- **Deployment Model**: Not defined yet; output is a static Vite build (`dist/`)
|
||||
- **IaC**: None beyond generated web server configs in `web/deploy/`
|
||||
- **Deployment Model**: Static `dist/` build. Test: scp to nginx on a Raspberry Pi (auto on push to master). Production: FTPS to an IIS webhost (manual, `release/*` only, after Lighthouse)
|
||||
- **Security headers**: Strict CSP — `script-src 'self'` + Umami, `connect-src 'self'` + Umami + Sentry, **`form-action 'self'`**, `frame-ancestors 'none'`. Any third-party form or script endpoint must be added here (and regenerated into the server configs)
|
||||
- **Networking**: N/A
|
||||
|
||||
@@ -7,7 +7,9 @@ graph LR
|
||||
Visitor["Website visitor (prospective client)"] --> Site["Andrea Slop Fotografie website (React SPA)"]
|
||||
Crawler["Search engines and link previews"] --> Site
|
||||
Site --> Social["Facebook and Instagram profiles"]
|
||||
Site --> Mail["E-mail (info@andreaslop.nl)"]
|
||||
Site --> Mail["E-mail (mailto, address assembled in the browser)"]
|
||||
Site --> Umami["Umami (cookieless visitor stats)"]
|
||||
Site --> Sentry["Sentry (JS error reports)"]
|
||||
Owner["Andrea (photographer, content owner)"] -.-> CMS["Planned .NET API / CMS"]
|
||||
CMS -.-> Site
|
||||
classDef person fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
|
||||
@@ -16,32 +18,46 @@ graph LR
|
||||
classDef planned fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,stroke-dasharray:5 5,color:#000;
|
||||
class Visitor,Owner,Crawler person;
|
||||
class Site system;
|
||||
class Social,Mail external;
|
||||
class Social,Mail,Umami,Sentry external;
|
||||
class CMS planned;
|
||||
```
|
||||
|
||||
Text alternative: visitors and crawlers use the website, which links out to social profiles and e-mail; a planned .NET API/CMS (dashed) will later supply content managed by Andrea.
|
||||
Text alternative: visitors and crawlers use the website, which links out to social profiles and e-mail and reports to Umami and Sentry; a planned .NET API/CMS (dashed) will later supply content managed by Andrea.
|
||||
|
||||
## 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 replaces an existing WordPress (Solene theme) site at andreaslop.nl.
|
||||
- **Business Transactions** (current state — front-end only, no back-end yet):
|
||||
- **Browse the homepage** — hero slider with featured photos, call-to-action to "Over mij"
|
||||
- **Navigate between pages** — header navigation (desktop) and hamburger menu (mobile)
|
||||
- **Visit social profiles** — Facebook / Instagram links in the hero
|
||||
- **Share / discover pages** — per-page title, meta description and Open Graph tags for search engines and link previews
|
||||
- *Planned (static design only)*: portfolio browsing with lightbox, shoot types and pricing, contact form, Instagram feed
|
||||
- **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"
|
||||
- **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
|
||||
- **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
|
||||
- **Info menu / side area** — slide-in panel from the design with socials and e-mail (out of scope for this site, by owner decision)
|
||||
- **Highlights / Lifestyle fotografie** — homepage intro section with a four-photo gallery
|
||||
- **Package (pakket)** — a priced shoot offer (Newborn, Zwangerschap, Loveshoot) with what is included
|
||||
- **Shoot** — a photo session type (newborn, pregnancy, loveshoot, portraits)
|
||||
- **CMS** — the planned .NET API that will provide page content; content is hard-coded until then
|
||||
- **Info menu / side area** — slide-in panel from the design (out of scope, by owner decision)
|
||||
- **CMS** — the planned .NET API that will provide page content and receive the contact form; content is hard-coded in `web/src/content/` until then
|
||||
- **Placeholder page** — a route that exists for navigation but shows "in de maak" and is `noindex`
|
||||
|
||||
## Component Level Business Descriptions
|
||||
### web (React front-end)
|
||||
- **Purpose**: The public website visitors see
|
||||
- **Responsibilities**: Page routing, layout shell, homepage hero, SEO head tags, design system (colours, fonts, buttons)
|
||||
- **Responsibilities**: Page routing, layout shell, homepage hero, SEO, monitoring, design system, server configuration for test (nginx) and production (IIS)
|
||||
|
||||
### .gitea/workflows (CI/CD)
|
||||
- **Purpose**: Quality gate and delivery
|
||||
- **Responsibilities**: Lint, format, tests, build, audit, Lighthouse; deploy to test on merge to master; deploy to production manually from `release/*`
|
||||
|
||||
### design/andreaslop-static (reference only)
|
||||
- **Purpose**: Static HTML/CSS/JS rebuild of the live site, used as the visual and structural source of truth
|
||||
- **Responsibilities**: Defines page sections, header/footer markup, design tokens and interactions to port to React
|
||||
- **Purpose**: Static HTML/CSS/JS rebuild of the live site, the visual and structural source of truth
|
||||
- **Responsibilities**: Defines page sections, markup, design tokens and interactions to port to React
|
||||
|
||||
### api (planned)
|
||||
- **Purpose**: .NET back-end for content and the contact form
|
||||
- **Responsibilities**: None yet — the folder is empty
|
||||
|
||||
@@ -1,26 +1,23 @@
|
||||
# Code Quality Assessment
|
||||
|
||||
## Test Coverage
|
||||
- **Overall**: None
|
||||
- **Unit Tests**: None (no test runner installed)
|
||||
- **Integration Tests**: None
|
||||
- Verification so far is `tsc` type-checking during `pnpm build` and manual browser checks
|
||||
- **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
|
||||
- **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)
|
||||
|
||||
## Code Quality Indicators
|
||||
- **Linting**: Not configured (TypeScript `noUnused*` flags only)
|
||||
- **Code Style**: Mostly consistent (Prettier: 4 spaces, single quotes). Exception: `routes/over-mij.tsx` uses double quotes and 2-space indent
|
||||
- **Documentation**: Good inline comments in Dutch explaining intent; README is a stub
|
||||
- **Linting**: ESLint (typescript-eslint, react-hooks, jsx-a11y), enforced in CI
|
||||
- **Code Style**: Consistent, Prettier-enforced in CI
|
||||
- **Documentation**: Short Dutch comments explaining *why*, often referencing requirement IDs (FR-xx, BR-xx, NFR-xx, Mx) from earlier AI-DLC features
|
||||
|
||||
## Technical Debt
|
||||
- `theme.ts` `globalCss.body.height: '250vh'` — temporary scroll-testing hack; forces every page to be 2.5 screens tall
|
||||
- `components/Footer.tsx` and `routes/over-mij.tsx` use Tailwind-style `className`s (`p-2`, `text-sm`, …) that do nothing — Tailwind is not installed
|
||||
- `AppShell` has no `<main>` landmark; static design has a skip link targeting `#main`
|
||||
- Header logo is not a link to the homepage (design: link with aria-label)
|
||||
- Social links are defined inside `Hero/heroContent.ts`; the footer in the design needs the same links → candidate for shared site-level content
|
||||
- `NavigationBar.tsx` uses `let [open, setOpen]` (should be `const`)
|
||||
- Unused Vite starter assets: `assets/hero.png`, `assets/typescript.svg`, `assets/vite.svg`
|
||||
- Design asset `footer-mark.png` (footer logo) not yet present in `web/src/assets`
|
||||
- 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
|
||||
|
||||
## Patterns and Anti-patterns
|
||||
- **Good Patterns**: design tokens as single source of truth; API-shaped static content; accessible interactions (aria labels, Escape to close, reduced motion, focus-visible handling); shared `navItems` for desktop and mobile
|
||||
- **Anti-patterns**: no-op `className` usage (see above); global body height hack
|
||||
- **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)
|
||||
- **Anti-patterns**: None significant found
|
||||
|
||||
@@ -1,12 +1,15 @@
|
||||
# Code Structure
|
||||
|
||||
## Build System
|
||||
- **Type**: npm-compatible via **pnpm** (lockfile `web/pnpm-lock.yaml`)
|
||||
- **Type**: pnpm (`packageManager: pnpm@12.11.2`, lockfile `web/pnpm-lock.yaml`)
|
||||
- **Configuration**:
|
||||
- `web/package.json` — scripts `dev` (vite), `build` (`tsc && vite build`), `preview`, `typegen` (Chakra typegen for theme)
|
||||
- `web/vite.config.js` — TanStack Router plugin (`autoCodeSplitting`) before `@vitejs/plugin-react`; `resolve.tsconfigPaths`
|
||||
- `web/tsconfig.json` — strict-ish bundler mode, `@/*` → `src/*` alias, `noUnusedLocals/Parameters`, `erasableSyntaxOnly`
|
||||
- `web/package.json` — scripts `dev`, `build` (`tsc && vite build`), `preview`, `test` (vitest + coverage), `lint`, `format:check`, `audit:deps`, `audit:dev`, `lighthouse`, `server-config`, and `check` (all of them in sequence)
|
||||
- `web/vite.config.ts` — TanStack Router plugin (`autoCodeSplitting`) before React plugin, sitemap plugin, security headers on dev/preview, Vitest config (jsdom, 20 s timeout, 100% coverage threshold for `src/lib/**`, `seo.ts`, `sitemap.ts`)
|
||||
- `web/tsconfig.json` — bundler mode, `@/*` → `src/*`
|
||||
- `web/eslint.config.js` — JS + typescript-eslint + react-hooks + jsx-a11y recommended
|
||||
- `web/.prettierrc` — 4 spaces, single quotes, semicolons
|
||||
- `web/lighthouserc.cjs` / `.desktop.cjs` — Lighthouse CI against `pnpm preview` (accessibility and best practices 1.0, performance 0.9; home mobile 0.8)
|
||||
- `.gitea/workflows/continuous_integration.yaml` — jobs `check`, `deploy-test`, `lighthouse`, `deploy-production`
|
||||
|
||||
## Key Classes/Modules
|
||||
|
||||
@@ -14,80 +17,97 @@
|
||||
graph TD
|
||||
Root["routes/__root.tsx"] --> AppShell["components/AppShell.tsx"]
|
||||
AppShell --> NavigationBar["NavigationBar/NavigationBar.tsx"]
|
||||
AppShell --> Footer["components/Footer.tsx"]
|
||||
AppShell --> Footer["Footer/Footer.tsx"]
|
||||
AppShell --> BackToTop["BackToTop/BackToTop.tsx"]
|
||||
AppShell --> Umami["Analytics/UmamiAnalytics.tsx"]
|
||||
NavigationBar --> NavLink["NavigationBar/NavLink.tsx"]
|
||||
NavigationBar --> MobileNav["NavigationBar/MobileNav.tsx"]
|
||||
NavigationBar --> navItems["NavigationBar/navItems.ts"]
|
||||
MobileNav --> navItems
|
||||
NavigationBar --> useScrolledPast["hooks/useScrolledPast.tsx"]
|
||||
NavigationBar --> navigation["navigation.ts"]
|
||||
Footer --> navigation
|
||||
Index["routes/index.tsx"] --> Hero["Hero/Hero.tsx"]
|
||||
Hero --> HeroArrows["Hero/HeroArrows.tsx"]
|
||||
Hero --> HeroPause["Hero/HeroPauseButton.tsx"]
|
||||
Hero --> HeroSocials["Hero/HeroSocials.tsx"]
|
||||
Hero --> useHeroSlider["Hero/useHeroSlider.ts"]
|
||||
Hero --> LinkButton["components/LinkButton.tsx"]
|
||||
HeroSocials --> socialPlatforms["Hero/socialPlatforms.ts"]
|
||||
LinkButton --> RouterLink["components/RouterLink.tsx"]
|
||||
Placeholder["routes/contact.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,NavLink,MobileNav shell;
|
||||
class Index,Hero,HeroArrows,HeroSocials page;
|
||||
class navItems,useScrolledPast,useHeroSlider,LinkButton,socialPlatforms util;
|
||||
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;
|
||||
```
|
||||
|
||||
Text alternative: the root route renders AppShell (NavigationBar with NavLink/MobileNav/navItems, plus Footer); the index route renders Hero with its arrows, socials, slider hook and the shared LinkButton.
|
||||
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.
|
||||
|
||||
### Existing Files Inventory
|
||||
- `web/index.html` — HTML entry; static fallback title/meta for non-JS crawlers (`data-fallback`)
|
||||
- `web/src/main.tsx` — bootstrap: providers, router, fonts, removes fallback head tags
|
||||
- `web/src/routeTree.gen.ts` — generated by TanStack Router plugin (do not edit)
|
||||
- `web/src/routes/__root.tsx` — root layout route, site-wide head
|
||||
- `web/src/routes/index.tsx` — home page (`/`), renders Hero
|
||||
- `web/src/routes/over-mij.tsx` — about page (`/over-mij`), placeholder content
|
||||
- `web/src/components/AppShell.tsx` — shell: NavigationBar + Outlet + Footer
|
||||
- `web/src/components/Footer.tsx` — placeholder footer
|
||||
- `web/src/components/LinkButton.tsx` — router `Link` styled with `linkButton` recipe
|
||||
- `web/src/components/NavigationBar/NavigationBar.tsx` — header, logo, desktop nav, hamburger
|
||||
- `web/src/components/NavigationBar/NavLink.tsx` — desktop nav link with underline animation
|
||||
- `web/src/components/NavigationBar/MobileNav.tsx` — full-screen mobile menu
|
||||
- `web/src/components/NavigationBar/navItems.ts` — menu items (Home, Over mij)
|
||||
- `web/src/components/Hero/*` — hero slider (component, arrows, socials, hook, content, types, platforms)
|
||||
- `web/src/hooks/useScrolledPast.tsx` — boolean "scrolled past threshold" hook
|
||||
- `web/src/recipes/linkButton.ts` — Chakra recipe for the square design button
|
||||
- `web/src/theme.ts` — Chakra system config (tokens, semantic tokens, text styles, recipes)
|
||||
- `web/src/seo.ts` — `pageHead` / `siteHead` helpers
|
||||
- `web/src/assets/*` — hero photos, light/dark logos, unused Vite starter assets (`hero.png`, `typescript.svg`, `vite.svg`)
|
||||
- `web/public/favicon.png`, `web/public/icons.svg` — static public assets
|
||||
Candidates for modification are marked with ★ for the homepage-sections 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/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/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/StatusPage/*` — StatusPage layout, NotFound, ErrorPage
|
||||
- `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/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/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/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
|
||||
|
||||
## Design Patterns
|
||||
### Chakra `chakra()` factory around router `Link`
|
||||
- **Location**: NavLink, MobileNav, LinkButton
|
||||
- **Purpose**: Router-aware links with Chakra style props and `_currentPage` / `aria-current` styling
|
||||
- **Implementation**: `const ChakraLink = chakra(Link)`
|
||||
### API-shaped static content
|
||||
- **Location**: `content/types.ts` + `content/*.ts`
|
||||
- **Purpose**: Hard-coded today, swappable for API responses later
|
||||
- **Implementation**: Plain data objects typed with interfaces, passed to components as props from the route (or AppShell)
|
||||
|
||||
### Pure helpers with property-based tests
|
||||
- **Location**: `lib/`, `seo.ts`, `sitemap.ts`
|
||||
- **Purpose**: Logic that decides what is shown (e.g. invalid social → hidden, invalid e-mail → column omitted) lives outside components and is tested with fast-check
|
||||
- **Implementation**: Small exported functions, 100% coverage threshold, shared arbitraries in `test/arbitraries.ts`
|
||||
|
||||
### Design tokens + recipes
|
||||
- **Location**: theme.ts, recipes/
|
||||
- **Location**: `theme.ts`, `recipes/`
|
||||
- **Purpose**: Single source for colours, fonts, spacing, motion; reusable component variants
|
||||
- **Implementation**: `defineConfig` tokens/semanticTokens/textStyles, `defineRecipe` + `useRecipe`
|
||||
|
||||
### API-shaped static content
|
||||
- **Location**: Hero/heroContent.ts + types.ts, navItems.ts
|
||||
- **Purpose**: Hard-coded content today, swappable for CMS API responses later
|
||||
- **Implementation**: Plain data objects typed with interfaces; components receive them as props
|
||||
### Page registry
|
||||
- **Location**: `sitePages.ts`, typed by `RoutePath`
|
||||
- **Purpose**: One source for head tags and the sitemap; `indexed: false` for placeholders
|
||||
|
||||
### Route-level head management
|
||||
- **Location**: seo.ts, each route's `head` option, `HeadContent` in root
|
||||
- **Purpose**: Per-page SEO without SSR
|
||||
### Configuration as code for hosting
|
||||
- **Location**: `config/securityHeaders.ts` → `config/serverConfig.ts` → `deploy/`
|
||||
- **Purpose**: Same headers in dev, preview, nginx (test) and IIS (production); a test guards drift
|
||||
|
||||
### Accessibility by default
|
||||
- **Location**: across components; `test/axe.ts` in component tests; Lighthouse in CI
|
||||
- **Implementation**: landmarks, skip link, focus management, live regions, visible focus ring, 44px targets, reduced motion
|
||||
|
||||
## Critical Dependencies
|
||||
### @chakra-ui/react
|
||||
- **Version**: ^3.37.0
|
||||
- **Usage**: All layout and styling
|
||||
- **Purpose**: Component library and styling system
|
||||
### @tanstack/react-router (+ router-plugin)
|
||||
- **Version**: ^1.170.39 / ^1.168.40
|
||||
- **Usage**: File-based routes, `Link`, `Outlet`, `HeadContent`, `useRouterState`
|
||||
- **Purpose**: Routing and head management
|
||||
### @iconify/react + @iconify-icons/ant-design
|
||||
- **Version**: ^6.0.2 / 2.0.1
|
||||
- **Usage**: Offline icons in Hero
|
||||
- **Purpose**: Icons bundled at build time (no API calls)
|
||||
### @chakra-ui/react ^3.37.0
|
||||
- **Usage**: All layout and styling; typegen from `theme.ts` on install
|
||||
### @tanstack/react-router ^1.170.39 (+ router-plugin ^1.168.40)
|
||||
- **Usage**: File-based routes, `Link`, `Outlet`, `HeadContent`, typed `RoutePath`
|
||||
### @sentry/react ^11.8.0
|
||||
- **Usage**: Error reporting, lazy-loaded after the load event
|
||||
### @iconify/react ^6.0.2 + @iconify-icons/ant-design 2.0.1
|
||||
- **Usage**: Offline icons (bundled at build time)
|
||||
|
||||
@@ -4,21 +4,23 @@
|
||||
- `web` — React 19 SPA (Vite, Chakra UI v3, TanStack Router): the public website
|
||||
|
||||
## Infrastructure Packages
|
||||
- None (no IaC, Docker, or CI/CD configuration present)
|
||||
- `.gitea/workflows/continuous_integration.yaml` — Gitea Actions CI/CD (check, lighthouse, deploy-test, deploy-production)
|
||||
- `web/config/` + `web/deploy/` — security headers and generated nginx (test) / IIS (production) configuration
|
||||
|
||||
## Shared Packages
|
||||
- None as separate packages. Inside `web`, shared modules are `theme.ts`, `recipes/`, `seo.ts`, `hooks/`, `components/LinkButton.tsx`
|
||||
- None as separate packages. Inside `web`: `theme.ts`, `recipes/`, `content/`, `lib/`, `seo.ts`, `navigation.ts`, `hooks/`, `components/LinkButton.tsx`, `components/RouterLink.tsx`, `components/PageIntro/`
|
||||
|
||||
## Test Packages
|
||||
- None
|
||||
- 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
|
||||
|
||||
## Reference (non-code)
|
||||
- `design/andreaslop-static` — static HTML/CSS/JS design reference (not built or deployed)
|
||||
- `design/AndreaSlopFotografie_React.zip` — archive of design files
|
||||
- `api/` — empty placeholder for the planned .NET API
|
||||
|
||||
## Total Count
|
||||
- **Total Packages**: 1
|
||||
- **Total Packages**: 1 (plus CI workflow and server config)
|
||||
- **Application**: 1
|
||||
- **Infrastructure**: 0
|
||||
- **Infrastructure**: 1 (CI/CD + server config, inside the repo)
|
||||
- **Shared**: 0
|
||||
- **Test**: 0
|
||||
- **Test**: 0 (co-located)
|
||||
|
||||
@@ -4,51 +4,51 @@
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
routes["routes/*"] --> components["components/*"]
|
||||
routes --> seo["seo.ts"]
|
||||
main["main.tsx"] --> theme["theme.ts + recipes"]
|
||||
main --> routes["routes/*"]
|
||||
main --> monitoring["monitoring/*"]
|
||||
routes --> components["components/*"]
|
||||
routes --> content["content/*"]
|
||||
routes --> seo["seo.ts + sitePages.ts"]
|
||||
components --> lib["lib/*"]
|
||||
components --> hooks["hooks/*"]
|
||||
components --> theme["theme.ts tokens (via Chakra props)"]
|
||||
components --> navigation["navigation.ts"]
|
||||
components --> assets["assets/*"]
|
||||
main["main.tsx"] --> theme
|
||||
main --> routes
|
||||
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 seo,hooks,theme,assets support;
|
||||
class theme,monitoring,content,seo,lib,hooks,navigation,assets support;
|
||||
class config build;
|
||||
```
|
||||
|
||||
Text alternative: main depends on theme and routes; routes depend on components and seo; components depend on hooks, theme tokens and assets.
|
||||
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).
|
||||
|
||||
### routes depend on components
|
||||
### routes depend on content and components
|
||||
- **Type**: Compile
|
||||
- **Reason**: Routes render AppShell (root) and page components
|
||||
- **Reason**: Routes pass static content objects into components as props
|
||||
|
||||
### config depends on monitoring/config.ts
|
||||
- **Type**: Build time (Node)
|
||||
- **Reason**: CSP `script-src`/`connect-src` include the Umami and Sentry origins; that file therefore has no Vite imports
|
||||
|
||||
### components depend on theme tokens
|
||||
- **Type**: Runtime (string token references such as `bg="paper"`, `h="header"`)
|
||||
- **Reason**: All visual values come from the Chakra system
|
||||
- **Type**: Runtime (string token references such as `bg="paper.alt"`, `textStyle="eyebrow"`)
|
||||
|
||||
## External Dependencies
|
||||
### @chakra-ui/react
|
||||
- **Version**: ^3.37.0
|
||||
- **Purpose**: Styling system and UI primitives
|
||||
- **License**: MIT
|
||||
### @tanstack/react-router
|
||||
- **Version**: ^1.170.39
|
||||
- **Purpose**: Routing
|
||||
- **License**: MIT
|
||||
### react / react-dom
|
||||
- **Version**: ^19.3.0
|
||||
- **Purpose**: UI runtime
|
||||
- **License**: MIT
|
||||
### next-themes
|
||||
- **Version**: ^0.4.6
|
||||
- **Purpose**: Colour mode
|
||||
- **License**: MIT
|
||||
### @iconify/react, @iconify-icons/ant-design
|
||||
- **Version**: ^6.0.2, 2.0.1
|
||||
- **Purpose**: Icons
|
||||
- **License**: MIT (icons: Ant Design, MIT)
|
||||
### @fontsource/jost, @fontsource/marcellus
|
||||
- **Version**: ^5.3.0
|
||||
- **Purpose**: Self-hosted web fonts
|
||||
- **License**: OFL-1.1
|
||||
### @chakra-ui/react ^3.37.0, @emotion/react ^11.14.0
|
||||
- **Purpose**: Styling system and UI primitives — **License**: MIT
|
||||
### @tanstack/react-router ^1.170.39
|
||||
- **Purpose**: Routing — **License**: MIT
|
||||
### react / react-dom ^19.3.0
|
||||
- **Purpose**: UI runtime — **License**: MIT
|
||||
### @sentry/react ^11.8.0
|
||||
- **Purpose**: Error reporting — **License**: MIT
|
||||
### @fontsource/jost, @fontsource/marcellus ^5.3.0
|
||||
- **Purpose**: Self-hosted fonts — **License**: OFL-1.1
|
||||
### @iconify/react ^6.0.2, @iconify-icons/ant-design 2.0.1 (dev)
|
||||
- **Purpose**: Icons, bundled at build time — **License**: MIT
|
||||
### Dev tooling
|
||||
- Vite, Vitest, Testing Library, fast-check, axe-core, ESLint, Prettier, Lighthouse CI, Chakra CLI — all MIT/Apache-2.0/MPL-2.0 (axe-core)
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
# Reverse Engineering Metadata
|
||||
|
||||
**Analysis Date**: 2026-10-14T09:58:04Z
|
||||
**Analysis Date**: 2026-10-19T19:19:38Z (refresh; previous analysis 2026-10-14T09:58:04Z at 8f5841c)
|
||||
**Analyzer**: AI-DLC
|
||||
**Workspace**: C:\Users\bdslo\Documents\Development\AndreaSlopFotografie
|
||||
**Codebase Commit**: 8f5841c (branch feature/hero-slider-and-navigation)
|
||||
**Total Files Analyzed**: 30 (web/src, web config files, design/andreaslop-static shell markup and README)
|
||||
**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
|
||||
|
||||
## Artifacts Generated
|
||||
- [x] business-overview.md
|
||||
|
||||
@@ -1,28 +1,37 @@
|
||||
# Technology Stack
|
||||
|
||||
## Programming Languages
|
||||
- TypeScript — ~6.0.2 — all application code (TSX)
|
||||
- TypeScript — ~6.0.2 — all application, config and test code (TSX)
|
||||
- HTML/CSS/JS — design reference only (`design/andreaslop-static`)
|
||||
- C# / .NET — planned back-end (not present)
|
||||
|
||||
## Frameworks
|
||||
- React — ^19.3.0 — UI
|
||||
- Chakra UI — ^3.37.0 (+ @emotion/react ^11.14.0) — styling system and components
|
||||
- TanStack Router — ^1.170.39 — file-based routing, head management (devtools ^1.167.2)
|
||||
- next-themes — ^0.4.6 — colour mode provider (fixed to light)
|
||||
- TanStack Router — ^1.170.39 — file-based routing, head management (devtools ^1.167.2, dev only)
|
||||
- @fontsource/jost, @fontsource/marcellus — ^5.3.0 — self-hosted fonts
|
||||
- @iconify/react ^6.0.2 + @iconify-icons/ant-design 2.0.1 — offline icons
|
||||
- @sentry/react — ^11.8.0 — error reporting
|
||||
|
||||
## Infrastructure
|
||||
- None yet; static build output suitable for any static host
|
||||
- Gitea Actions — CI/CD (runners: Raspberry Pi arm64 and a pc)
|
||||
- nginx on Raspberry Pi — test environment (test.andreaslop.nl)
|
||||
- IIS at a webhost via FTPS — production (andreaslop.nl)
|
||||
- Sentry (SaaS, EU), Umami (self-hosted, analytics.slpsoftware.nl), UptimeRobot — monitoring
|
||||
|
||||
## Build Tools
|
||||
- Vite — ^8.3.0 — dev server and bundler
|
||||
- @vitejs/plugin-react — ^6.1.1
|
||||
- @vitejs/plugin-react — ^6.1.2
|
||||
- @tanstack/router-plugin — ^1.168.40 — route tree generation, code splitting
|
||||
- @chakra-ui/cli — ^3.37.0 — theme typegen
|
||||
- pnpm — package manager
|
||||
- Prettier — ^3.9.9 — formatting
|
||||
- pnpm — 12.11.2 — package manager
|
||||
- Node — 24 (CI)
|
||||
|
||||
## Testing Tools
|
||||
- None configured (no test runner, no linter such as ESLint)
|
||||
## Quality and Testing Tools
|
||||
- Vitest ^5.0.5 + @vitest/coverage-v8 — unit and component tests, coverage thresholds
|
||||
- @testing-library/react ^16.3.3, user-event, jest-dom, jsdom ^30.1.3
|
||||
- fast-check ^4.10.2 — property-based tests
|
||||
- axe-core ^4.14.0 — accessibility checks in component tests
|
||||
- ESLint ^9.39.5 + typescript-eslint, react-hooks, jsx-a11y
|
||||
- Prettier ^3.9.9
|
||||
- @lhci/cli ^0.15.1 — Lighthouse CI (mobile and desktop)
|
||||
|
||||
Reference in New Issue
Block a user