Werkwijze & Standaarden

Een samenvatting van de kernprincipes uit de obi-docs.

De Wet van Layout (The Law)

Elke pagina moet strikt deze hiërarchie volgen voor consistentie: 

Main -> Section -> Container -> Content
  • Section: Beheert verticale witruimte en semantische verdeling.
  • Container: Beheert horizontale breedte en padding.
  • Uitzonderingen: Geen. Ook de homepage volgt dit, maar gebruikt een Hero component i.p.v. PageHeader.

Naamgeving (Conventies)

We volgen een strikte 80/20 set regels voor duidelijkheid:

  • Pagina's: Lowercase (folder-based routing met index.astro).
  • Componenten: PascalCase (bv. HeroHome.astro).
  • Mappen: Lowercase (bv. src/components/blocks/).

Meertaligheid (i18n)

We gebruiken een Manual Routing Map strategie in plaats van automatische magie.

  • Bron van Waarheid: src/config/routes.ts definieert alle relaties.
  • Expliciete Props: locale en pageKey worden expliciet doorgegeven.
  • Geen Redirects: De URL is leidend. Geen cookies, geen detectie.

Dev Workflow

  • npm run dev voor ontwikkeling (gebruikt src/).
  • npm run build voor productie output (maakt dist/).
  • npm run preview om de build te controleren.