logo hsb.horse

Registro de Decisão de Arquitetura

Estratégia de i18n do manifest PWA

Gerar manifests específicos por locale com lang/name/short_name localizados.

Aceito #pwa #i18n

Estratégia de i18n do manifest PWA

Decisão

  • Gerar manifest.{locale}.webmanifest para cada locale usando endpoints Astro
  • Cada manifest varia lang, name e short_name por locale
  • Favicon.astro referencia o manifest específico do locale

Contexto

O site suporta 6 locales (ja, en, ko, fr, de, pt), mas o manifest estava fixo em lang: "ja". Para fornecer uma experiência PWA adequada, precisamos de manifests específicos por locale.

Justificativa

  • As melhores práticas de PWA exigem que o lang do manifest corresponda ao idioma da página
  • O nome do aplicativo (name, short_name) deve ser exibido adequadamente em cada idioma
  • A geração por endpoint Astro funciona com ambientes de hospedagem estática

Consequências

  • Os manifests são gerados como /brand/manifest.{locale}.webmanifest
  • Favicon.astro referencia o manifest apropriado com base no locale da página
  • Adicionar novos locales requer atualização de src/pages/brand/manifest.[lang].webmanifest.ts