Files
AndreaSlopFotografie/aidlc-docs/features/frontend-shell/construction/plans/frontend-shell-fd-change-questions.md
SluijsensandClaude Opus 5.5 069c7cb7eb Adds AI-DLC construction docs for the front-end shell feature
Functional design, NFR requirements, code generation plan and summary,
and build-and-test instructions with results.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:05:03 +02:00

6.0 KiB
Raw Permalink Blame History

Functional Design Change Questions — SEO, schermlezers, responsive, hergebruik

Je vroeg om SEO, schermlezers, responsive design en hergebruik via Chakra/thema meteen mee te nemen. Het grootste deel kan ik op vaste uitgangspunten uitwerken (zie "Wordt uitgewerkt zonder vraag"). Hieronder staan alleen de punten waar een echte keuze in zit. Vul per vraag de letter in na [Answer]:. Waar ik een voorkeur heb staat (aanbevolen).

Wordt uitgewerkt zonder vraag

SEO

  • Per pagina een unieke titel en beschrijving (bestaat al via pageHead). Placeholderpagina's en 404/fout krijgen noindex, zodat een lege "in de maak"-pagina niet in Google komt. Zodra de echte inhoud er staat, gaat noindex eraf.
  • Eén h1 per pagina, koppen in logische volgorde (geen niveaus overslaan). Footerkoppen zijn h2, opgemaakt als eyebrow: het zijn hoofdsecties van de pagina (gecorrigeerd bij het uitwerken, zie BR-SEO-09).
  • Interne links zijn echte <a href>-links (geen klik-handlers op divs), zodat zoekmachines ze kunnen volgen.
  • Alle afbeeldingen hebben een betekenisvolle alt, decoratieve krijgen alt="".

Schermlezers

  • lang="nl" (staat al), landmarks header/nav/main/footer met Nederlandse labels.
  • Skip link, zichtbare focusstijl op alles wat focus kan krijgen, en die focusstijl komt op één plek uit het thema in plaats van per component.
  • Iconen zijn aria-hidden; knoppen met alleen een icoon hebben een aria-label.
  • Externe links die in een nieuw tabblad openen, melden dat aan schermlezers ("opent in nieuw tabblad", visueel verborgen).
  • Respecteren van prefers-reduced-motion.

Responsive

  • Mobile-first, met de standaard Chakra-breakpoints (sm 480, md 768, lg 1024, xl 1280, 2xl 1536). Per component een tabel met wat er per breakpoint verandert.
  • Werkt van 320px breed tot 32:9 zonder horizontaal scrollen; tekst kan 200% vergroot worden zonder dat er iets wegvalt.
  • Klikdoelen minimaal 44×44px op touch (menu, footerlinks, to-top).

Hergebruik via Chakra en het thema

  • Een overzicht per component van welke tokens, text styles en recipes het gebruikt, en welke nieuwe gedeelde stukken erbij komen (bv. één pageTitle-text style voor de h1 van PageIntro en StatusPage, één focusRing voor de hele site, z-index-tokens voor header/menu/to-top in plaats van losse getallen).
  • Geen waarden die al als token bestaan, opnieuw hard in een component.

Questions

De site wordt in de browser opgebouwd. Google voert JavaScript uit en ziet dus de juiste titel per pagina. WhatsApp, Facebook en LinkedIn doen dat niet: die zien bij elke pagina alleen de vaste fallback uit index.html (de homepage-titel). Dat los je alleen op door de pagina's bij het bouwen al als HTML te genereren ("prerendering").

A) Nu nog niet prerenderen, maar alles zo bouwen dat het later zonder ombouw kan: alle head-data via de route-head, geen window/document tijdens het renderen, content via props. Prerendering wordt een vervolgpunt bij hosting/Operations. (aanbevolen) Prerendering is pas zinvol als er echte pagina-inhoud is; nu zijn het placeholders. B) Nu al prerendering toevoegen in deze feature (een build-stap die per route statische HTML maakt). Grotere scope en een extra afhankelijkheid. X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 2: Domein voor canonical-URL's en og:url

Voor canonical-URL's (voorkomt dubbele pagina's in Google) en voor link-previews is het definitieve adres nodig.

A) https://andreaslop.nl (zonder www) (aanbevolen) Komt overeen met het e-maildomein; www stuurt de host dan door. B) https://www.andreaslop.nl X) Anders (beschrijf hieronder na de Answer:-tag)

Zonder og:image tonen WhatsApp en Facebook een preview zonder plaatje.

A) Eén vaste site-brede afbeelding (een uitsnede van een hero-foto, 1200×630), die een pagina later kan overschrijven met een eigen beeld (aanbevolen) B) Het logo als preview-afbeelding C) Nog geen og:image X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 4: Gestructureerde data voor Google (JSON-LD)

Met gestructureerde data begrijpt Google dat dit een lokale fotograaf is (naam, plaats, socials). Dat helpt bij lokaal zoeken ("fotograaf Huizen").

A) Ja, site-breed één ProfessionalService-blok met naam, website, regio Huizen, logo en de social-links. Zonder e-mailadres, anders staat het adres alsnog leesbaar in de pagina. (aanbevolen) B) Nog niet, later met de echte pagina's X) Anders (beschrijf hieronder na de Answer:-tag)

Vraag 5: robots.txt en sitemap.xml

A) Beide als statisch bestand in public/. De sitemap bevat alleen de geïndexeerde pagina's (nu: home) en wordt bijgewerkt zodra er een pagina live gaat. Een test controleert dat de sitemap en de routes niet uit elkaar lopen. (aanbevolen) B) De sitemap wordt bij elke build automatisch gemaakt uit de routes. Meer werk nu, maar niets handmatig bij te houden. C) Later, bij hosting/Operations X) Anders (beschrijf hieronder na de Answer:-tag)

Answer: B is het makkelijkste. Hoeveel meerwerk is het en hoe wordt het automatisch opgebouwd? Hoe betrouwbaar is het? Bij teveel gedoe of onzekerheden is A het beste. Anders B, met eventueel de test uit optie A

Vraag 6: Paginawissel aankondigen aan schermlezers

Bij een gewone website leest een schermlezer na een klik de nieuwe pagina voor. In een app als deze gebeurt dat niet vanzelf: de inhoud wisselt, maar de schermlezer merkt het niet.

A) Na elke paginawissel (niet bij de eerste keer laden) gaat de focus naar main#main, net als bij de skip link en de to-top-knop. De schermlezer leest dan de nieuwe inhoud vanaf het begin. (aanbevolen) Eén consistent gedrag. B) De focus blijft staan en een onzichtbaar meldingsgebied leest de nieuwe paginatitel voor ("Portfolio, pagina geladen") X) Anders (beschrijf hieronder na de Answer:-tag)