> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 모바일 앱 현지화

4개의 제공 로케일, 타입 검사된 카탈로그, 영어 대체.

## 카탈로그 작동 방식

앱은 apps/mobile/src/i18n에 영어, 독일어, 스페인어, 프랑스어 카탈로그를 제공합니다 — 로케일당 하나의 타입 검사된 MobileCatalog이며, 점 경로와 {name} 보간으로 t(key, vars)로 조회합니다. 한 로케일에 없는 키는 영어 항목으로 대체되고, 복수형 문자열은 Intl.PluralRules로 형태를 선택합니다.


## 로케일 선택

기기 로케일은 런타임에 Intl API로 해석되고, 언어 접두사로 매칭되며, 영어로 대체됩니다 — pt-BR 기기는 포르투갈어가 MOBILE_LOCALES에 없으므로 영어를 보게 됩니다.


## 문자열과 로케일 추가

모든 새 키는 네 카탈로그 모두에 추가하세요 — 공유 카탈로그 타입은 한 로케일이라도 빠지면 typecheck에 실패합니다. 다섯 번째 로케일은 MobileLocale과 MOBILE_LOCALES를 확장하고 완전한 카탈로그를 작성해야 합니다. 모바일 카탈로그는 웹 앱의 i18n과 별개입니다. 자동으로 동기화되는 것이 없으므로 두 플랫폼에 존재하는 카피는 두 곳 모두에서 번역합니다.


## 검증 및 문제 해결

기기 언어를 제공되는 각 로케일과 지원되지 않는 로케일로 전환하고, 오프라인 배너의 상대 시간 같은 복수형 문자열을 모든 카탈로그에서 확인하세요. 화면에 날것의 점 키가 보이면 한 로케일에서 번역이 안 된 것이 아니라 모든 곳에서 키가 누락된 것입니다.


## 다음

[모듈 개요](https://supastack.dev/ko/docs/modules.md)