피드로 돌아가기
Why we picked Tolgee to localize an open-source database client
Dev.toDev.to
Frontend

8개 언어 지원 및 i18n 런타임 전환을 위한 Tolgee 도입을 통한 Localize 파이프라인 최적화

Why we picked Tolgee to localize an open-source database client

NewtTheWolf2026년 6월 19일4intermediate

Context

i18next 기반의 JSON 파일 수동 편집 방식으로 인한 번역 컨텍스트 부재와 기여자 경험 저하 발생. 특히 런타임을 Lingui로 마이그레이션하는 과정에서 라이브러리에 종속되지 않는 유연한 번역 관리 체계 필요성 대두.

Technical Solution

  • Self-hostable 오픈소스인 Tolgee 도입을 통한 Privacy-first 프로젝트 철학 유지 및 데이터 주권 확보
  • ICU 메시지 표준 기반의 문자열 관리로 i18next에서 Lingui로의 런타임 전환 시 마이그레이션 비용 최소화
  • 스크린샷 기반의 In-context Translation UI 채택을 통한 번역 정확도 향상 및 문맥 파악 병목 해결
  • Content Delivery 기능을 활용하여 앱 릴리스 주기와 무관하게 실시간 번역 업데이트가 가능한 OTA(Over-the-Air) 구조 설계
  • Offline-first 원칙 준수를 위해 번역 데이터를 앱 내 Bundle로 포함하고 온라인 연결 시에만 최신 데이터를 Overlay 하는 하이브리드 전략 채택

- i18n 라이브러리 교체 가능성을 고려하여 특정 프레임워크에 종속되지 않은 ICU 표준 포맷의 중간 저장소 검토 - 번역가에게 단순 키-값 쌍이 아닌 실제 UI 스크린샷을 제공하는 Context-rich 워크플로우 구축 - Git PR 기반의 번역 기여 진입장벽을 낮추기 위한 별도의 Community Translation UI 및 승인 프로세스 설계 - 최신 번역 반영 속도 개선을 위해 정적 번역 파일과 동적 API 업데이트를 병행하는 Fallback 전략 수립

원문 읽기