목록 보기
모노레포 환경에서 i18next 다국어 시스템 구축하기
프론트엔드

모노레포 환경에서 i18next 다국어 시스템 구축하기

무신사
무신사
2026년 3월 8일

두줄요약

모노레포 프론트엔드에서 i18next와 Lokalise를 연동해 다국어 시스템을 구축한 과정을 공유했습니다. 동적 import를 넘어 정적 import와 빌드 타임 언어 분리로 번들 크기와 로딩 시간을 줄였습니다.

핵심 내용

  • pnpm 모노레포의 여러 프론트엔드 앱에서 i18next 기반 다국어 시스템을 구축한 과정
  • Lokalise TMS와 GitHub Actions를 연동해 번역 파일을 가져오고 PR로 반영하는 워크플로우
  • 번역 로딩 구조를 동적 import에서 정적 import와 빌드 시점 언어 결정 방식으로 개선한 진화 과정
  • 번역키 정적 추출로 누락 키를 빌드 단계에서 감지하려는 관리 체계

구조와 흐름

  • 초기는 모든 언어를 한꺼번에 로드하는 단순 구조
  • 이후 앱별 번역 분리, 불필요한 ko 제거, VITE_LANG 기반 언어별 번들 분리로 최적화
  • 최종적으로 동기 초기화와 Tree-shaking을 살리는 구조로 전환

성능/운영 포인트

  • 불필요한 번역 리소스 제거로 번들 크기 절감
  • 9개 주요 앱 기준 741KB 절감과 평균 14.98% 감소
  • 네트워크 로딩 시간 감소와 번역 수정 이력 확인을 위한 슬랙 알림 운영

댓글 0

댓글을 작성하려면 로그인이 필요합니다.

댓글을 불러오는 중...