logo hsb.horse

Architecture Decision Record

Stratégie d'i18n du manifest PWA

Générer des manifests spécifiques aux locales avec lang/name/short_name localisés.

Accepté #pwa #i18n

Stratégie d’i18n du manifest PWA

Décision

  • Générer manifest.{locale}.webmanifest pour chaque locale en utilisant les endpoints Astro
  • Chaque manifest varie lang, name et short_name selon la locale
  • Favicon.astro référence le manifest adapté à la locale

Contexte

Le site prend en charge 6 locales (ja, en, ko, fr, de, pt), mais le manifest était fixé à lang: "ja". Pour fournir une expérience PWA appropriée, nous avons besoin de manifests spécifiques aux locales.

Justification

  • Les bonnes pratiques PWA exigent que le lang du manifest corresponde à la langue de la page
  • Le nom de l’application (name, short_name) doit s’afficher correctement dans chaque langue
  • La génération par endpoint Astro fonctionne avec les environnements d’hébergement statique

Conséquences

  • Les manifests sont générés sous la forme /brand/manifest.{locale}.webmanifest
  • Favicon.astro référence le manifest approprié en fonction de la locale de la page
  • L’ajout de nouvelles locales nécessite la mise à jour de src/pages/brand/manifest.[lang].webmanifest.ts