[i18n] Platform — Paraglide, locale URLs, resolution #908

New issue

Closed

opened 2026-05-06 19:49:48 +00:00 by claude-desktop · 0 comments

claude-desktop commented

2026-05-06 19:49:48 +00:00

Collaborator

Consolidates user stories US-A1, US-A2, US-A3 (see specs/i18n-paraglide-user-stories.md).

Spec

Paraglide + Vite (was US-A1)

Inlang project + per-locale message sources in git; official Paraglide Vite plugin in apps/web.
vite dev + message edits work with HMR (per Inlang).
bun run build succeeds with chosen codegen policy (commit vs CI-generated — recorded in spec open decisions).

Locale-aware routing (was US-A2)

/ redirects to /en/… or resolved locale.
Invalid locale prefix → redirect to a valid locale.
Single navigation primitive (LocaleLink or equivalent) preserves locale.
Post-login redirect uses canonical prefixed path.

Locale resolution (was US-A3)

Order: URL → server preferredLocale → localStorage → Accept-Language → en.
URL vs server preference mismatch → one canonical redirect (no split-brain).

Consolidates user stories **US-A1, US-A2, US-A3** (see `specs/i18n-paraglide-user-stories.md`). ## Spec - [specs/i18n-paraglide-user-stories.md](https://forge.jacquin.app/charles/claude-hooks/src/branch/main/specs/i18n-paraglide-user-stories.md) - [specs/i18n-paraglide.md](https://forge.jacquin.app/charles/claude-hooks/src/branch/main/specs/i18n-paraglide.md) --- ### Paraglide + Vite (was US-A1) - [ ] Inlang project + per-locale message sources in git; official Paraglide Vite plugin in `apps/web`. - [ ] `vite dev` + message edits work with HMR (per Inlang). - [ ] `bun run build` succeeds with chosen codegen policy (commit vs CI-generated — recorded in spec open decisions). ### Locale-aware routing (was US-A2) - [ ] `/` redirects to `/en/…` or resolved locale. - [ ] Invalid locale prefix → redirect to a valid locale. - [ ] Single navigation primitive (`LocaleLink` or equivalent) preserves locale. - [ ] Post-login redirect uses canonical prefixed path. ### Locale resolution (was US-A3) - [ ] Order: URL → server `preferredLocale` → `localStorage` → `Accept-Language` → `en`. - [ ] URL vs server preference mismatch → **one** canonical redirect (no split-brain).

claude-desktop added the

area:dashboard

type:user-story

labels

2026-05-06 19:49:56 +00:00

claude-desktop referenced this issue

2026-05-06 19:49:59 +00:00

[i18n] US-A1 — Paraglide in the Vite build #896

claude-desktop referenced this issue

2026-05-06 19:49:59 +00:00

[i18n] US-A2 — Locale-aware routing #897

claude-desktop referenced this issue