step 002 complete

openspec/specs/content-i18n/spec.md

@@ -0,0 +1,42 @@
+## Purpose
+
+Defines the content localisation system for the Qumo website, including the JSON content files structure and the `i18n.ts` helper that provides locale-appropriate content to pages and components.
+
+## Requirements
+
+### Requirement: Locale content JSON files contain global meta fields
+`src/content/en.json` and `src/content/nl.json` SHALL each contain a top-level `"meta"` key with the following fields:
+- `siteName: string` — the site name (e.g., `"Qumo"`)
+- `defaultTitle: string` — default page title (used as fallback)
+- `defaultDescription: string` — default meta description (used as fallback)
+- `defaultOgImage: string` — default OG image path; may be empty string initially
+
+#### Scenario: en.json has correct meta structure
+- **WHEN** `src/content/en.json` is parsed as JSON
+- **THEN** it SHALL have a `meta` object with string values for `siteName`, `defaultTitle`, `defaultDescription`, and `defaultOgImage`
+
+#### Scenario: nl.json has correct meta structure
+- **WHEN** `src/content/nl.json` is parsed as JSON
+- **THEN** it SHALL have the same `meta` object shape as `en.json`, with Dutch-language values for `defaultTitle` and `defaultDescription`
+
+### Requirement: i18n helper returns correct content for locale
+`src/content/i18n.ts` SHALL export a function `getContent(locale: string)` that returns the parsed content object for the given locale. It SHALL return the EN content object for any unrecognized locale string.
+
+#### Scenario: Returns EN content for "en" locale
+- **WHEN** `getContent("en")` is called
+- **THEN** the function SHALL return the parsed contents of `src/content/en.json`
+
+#### Scenario: Returns NL content for "nl" locale
+- **WHEN** `getContent("nl")` is called
+- **THEN** the function SHALL return the parsed contents of `src/content/nl.json`
+
+#### Scenario: Falls back to EN for unknown locale
+- **WHEN** `getContent("fr")` or any unrecognized locale string is called
+- **THEN** the function SHALL return the parsed contents of `src/content/en.json`
+
+### Requirement: Content files use static imports (no runtime fetch)
+The `i18n.ts` helper SHALL use static ES module imports (`import enContent from './en.json'`) rather than dynamic `fetch` or `fs.readFile`. This ensures type safety and tree-shaking at build time.
+
+#### Scenario: Build succeeds with static imports
+- **WHEN** `npm run build` is executed in the `website/` directory
+- **THEN** the build SHALL complete without errors, with locale content bundled statically