i18n Automation Toolkit · 2025.09 ~

I18Nexus

“i18n의 병목은 t() 호출이 아니라, 번역 키와 코드와 협업 문서가 서로 어긋나는 순간에 생겼습니다.”

하드코딩 문자열, JSON 리소스, 번역 시트, 타입 정의가 따로 움직이던 i18n 작업을 AST 기반 CLI와 type-safe runtime으로 묶은 자동화 툴킷입니다. 13,000+ 다운로드와 Google Sheets 동기화로 실제 사용성을 검증했습니다.

GitHub 저장소 →

역할

라이브러리 설계, AST 변환, CLI/DX 자동화

팀

개인 오픈소스

기여

기획·구현 100%

Live preview

실제 서비스 화면

i18nexus.pro →

런타임과 도구 생태계를 설명하는 실제 제품 사이트를 모바일 베젤 안에서 확인할 수 있습니다.

새 탭에서 보기 →

13,000+

누적 다운로드

80%

작업 시간 감축

0건

번역 키 휴먼 에러

01 · Problem

문제

i18n 부채는 t() 호출 누락보다 key naming, namespace, JSON resource, 번역 시트, 타입 정의가 서로 다른 시점에 깨지는 운영 문제였습니다.

02 · Role

역할

라이브러리 설계, AST 변환, CLI/DX 자동화 · 개인 오픈소스 · 기획·구현 100%

TypeScriptBabel ASTCLIGoogle Sheets APIReactNext.jsSSRi18nRust

03 · Approach

해결 과정

1 AST 분석으로 JSX 텍스트를 찾아 t() 래핑, key 생성, JSON 병합, 타입 생성을 한 번에 처리했습니다.
2 Google Sheets를 번역 협업의 source of truth로 두고 upload/download 명령을 만들었습니다.
3 runtime core와 tools가 같은 namespace/key 계약을 공유하게 해 코드와 리소스 불일치를 줄였습니다.
4 i18next보다 빠른 런타임이 아니라 React 앱의 번역 운영 비용을 줄이는 toolkit으로 메시지를 좁혔습니다.

04 · Packages

패키지 구성

Core runtime

i18nexus

React와 Next.js에서 namespace snapshot, typed t(), SSR helper를 담당하는 런타임 패키지입니다.

npm install i18nexus

React · SSR · type-safe runtime

컴포넌트 렌더 경로에서는 이미 준비된 snapshot을 조회하도록 설계했습니다.
server helper와 client hook이 같은 namespace/key 계약을 공유하게 만들었습니다.

npm →

Automation CLI

i18nexus-tools

하드코딩 문자열 탐지, t() 래핑, 번역 키 추출, 타입 생성, 진단, Google Sheets 동기화를 담당하는 자동화 CLI 패키지입니다.

npm install -D i18nexus-tools

AST · extract · type · sync

wrap, extract, type, diagnose, sync 흐름으로 반복적인 다국어 작업을 자동화했습니다.
runtime이 기대하는 key/type 계약을 빌드 전에 생성해 번역 리소스 drift를 줄였습니다.

npm →

05 · Results

성과

누적 다운로드

13,000+

외부 사용 검증

반복 작업 시간

수동 래핑/추출→ 자동 변환

80% 감축

번역 키 검증

런타임 확인→ 타입 검증

휴먼 에러 감소

협업 방식

개발자 중심 JSON 수정→ Google Sheets 동기화

비개발자 협업 가능

SSR 대응

client hook 중심→ server helper 제공

Next.js App Router 대응

06 · Records