목차
현지화 플랫폼은 투박한 인터페이스, 느린 편집기, 위원회에서 설계한 것 같은 워크플로우로 악명이 높습니다. 우리는 다른 철학으로 Better i18n을 구축했습니다: 모든 상호작용이 의도적이고, 빠르며, 개발자의 시간을 존중해야 합니다.
이 글은 Better i18n을 다르게 만드는 플랫폼 UX 기능들을 기능 목록이 아닌, 일상적인 워크플로우가 실제로 어떤 모습인지 실용적인 투어로 안내합니다.
명령 팔레트: 키보드 중심 탐색 허브
플랫폼 어디에서나 Cmd+K (Windows/Linux의 경우 Ctrl+K)를 누르십시오. 검색 오버레이가 즉시 나타나며, 프로젝트, 네임스페이스, 키, 설정, 작업 등 모든 것을 인덱싱합니다.
몇 자를 입력하면 결과가 실시간으로 좁혀집니다. 결과를 선택하면 바로 그곳으로 이동합니다. 브레드크럼 클릭 없음, 사이드바 탐색 없음, 페이지 리로드 없음. VS Code나 Raycast에서 생활하는 개발자에게 이 인터랙션 모델은 즉시 친숙하게 느껴집니다.
명령 팔레트는 탐색만 하는 것이 아닙니다. 작업도 노출합니다 — 새 키 생성, 언어 전환, 게시 트리거, 프로젝트 설정 열기. 플랫폼에서 하고 싶은 모든 것을 위한 범용 진입점으로 생각하십시오.
i18n 워크플로우에서 이것이 중요한 이유: 현지화 프로젝트에는 종종 수십 개의 네임스페이스와 수천 개의 키가 있습니다. 마우스 중심 탐색은 확장되지 않습니다. 명령 팔레트는 복잡한 다중 네임스페이스 프로젝트를 관리할 때도 플로우 상태를 유지합니다.
온보딩: 몇 분 안에 첫 번역까지
첫인상이 중요합니다. 새 팀원이 프로젝트에 합류하거나 Better i18n을 처음 설정할 때 온보딩 마법사가 모든 단계를 안내합니다:
- 리포지토리 연결 — GitHub, GitLab, 또는 Bitbucket 리포지토리 연결
- 프로젝트 구성 — 소스 언어 설정, 대상 언어 추가, 네임스페이스 정의
- SDK 설치 — Next.js, React + TanStack Router, Expo, 또는 Flutter에 대한 프레임워크별 지침
- 첫 번역 푸시 — 플랫폼에서 코드까지의 왕복 확인
각 단계는 진행하기 전에 유효성을 검사합니다. SDK 구성에 문제가 있으면 마법사가 즉시 포착하여 10분 후 프로덕션에서 발견하는 것을 방지합니다.
마법사는 또한 프레임워크를 자동으로 감지합니다. Next.js를 사용하고 있다면 Next.js별 설정 지침, 미들웨어 구성, 라우팅 예시를 얻습니다. Expo 사용자는 Expo별 안내를 봅니다. 일반적인 문서 페이지 없음 — 모든 것이 맞춤화됩니다.
번역 편집기: 성능과 단순성이 만나는 곳
팀이 대부분의 시간을 번역 편집기에서 보내므로, 가장 많은 엔지니어링 노력을 투자한 곳입니다.
대규모 키 세트를 위한 가상 스크롤링
대부분의 번역 편집기는 DOM에 모든 행을 렌더링합니다. 200개의 키에서는 잘 작동합니다. 2,000개의 키에서는 느려집니다. 5,000개 이상의 키에서는 사용 불가능해집니다.
Better i18n은 가상화된 렌더링을 사용합니다 — 뷰포트에 표시되는 행(플러스 작은 버퍼)만 DOM에 존재합니다. 결과: 10,000개의 키를 스크롤하는 것이 50개를 스크롤하는 것과 똑같이 느껴집니다. 메모리 사용량은 일정하게 유지됩니다. 프레임 속도는 높게 유지됩니다. 브라우저가 히터가 되지 않습니다.
이것은 단순히 좋으면 좋은 기능이 아닙니다. 규모에서의 실제 프로젝트는 일상적으로 5,000~20,000개의 키를 가지고 있습니다. 편집기가 이를 우아하게 처리할 수 없다면, 도구가 아닌 병목이 됩니다.
자동 동기화가 있는 인라인 편집
번역 셀을 클릭하고 입력을 시작합니다. 편집 모드 없음, 모달 없음, "저장" 버튼 없음. 그냥 클릭하고, 입력하고, 계속 진행합니다.
내부적으로 Zustand 기반 스토어가 변경 사항을 추적하고 3.5초 디바운스로 서버와 동기화합니다. 3.5초 동안 입력을 멈추면 변경 사항이 자동으로 저장됩니다. 도구 모음의 미묘한 동기화 표시기가 현재 상태 — 편집 중, 동기화 중, 또는 저장됨 — 를 보여줍니다.
이 자동 동기화 패턴은 사용자 오류의 전체 범주를 제거합니다. 저장을 잊어버려서 작업을 잃는 일이 없습니다. 밤새 탭을 열어 두어서 오래된 데이터가 생기는 일이 없습니다. 편집기는 항상 최신 상태를 반영합니다.
네임스페이스 그룹화 및 필터링
대규모 프로젝트는 번역을 네임스페이스로 구성합니다 — common, auth, dashboard, emails 등. 편집기는 이를 접을 수 있는 그룹으로 렌더링합니다. 작업 중인 네임스페이스를 펼치고 나머지는 접습니다.
언어와 번역 상태(번역됨, 번역되지 않음, 검토 필요)별 필터링과 결합하면 중요한 작업에 정확히 집중할 수 있습니다. auth 네임스페이스에서 번역되지 않은 독일어 키를 모두 보고 싶으신가요? 두 번의 필터 클릭이면 됩니다.
검색은 키 이름과 번역 값 모두에서 작동합니다. 누군가 "Click here"라고 쓴 특정 키를 찾고 있으신가요? 값을 검색하고, 키를 찾고, 수정하십시오.
활동 로그: 모든 작업에 대한 완전한 감사 추적
활동 로그는 프로젝트에서 일어나는 모든 것을 추적합니다 — 키 생성, 번역 업데이트, 게시, 설정 변경, 구성원 추가 등. 각 항목은 작업을 수행한 사람, 발생 시간, 영향을 받은 리소스를 기록합니다.
이것은 규정 준수를 위해서만이 아닙니다. 활동 로그는 실용적인 디버깅 도구입니다. 프로덕션에서 번역이 잘못 보이면 이를 유발한 정확한 변경 사항을 추적할 수 있습니다 — 누가 키를 업데이트했는지, 언제, 이전 값이 무엇이었는지.
여러 언어에 걸쳐 번역가를 관리하는 팀 리더에게 활동 로그는 마이크로 관리 없이 번역 속도와 팀 활동에 대한 가시성을 제공합니다.
글로벌 AI 드로어: 어디서나 컨텍스트 인식 지원
어느 페이지에서나 AI 채팅 패널을 엽니다. 현재 프로젝트, 보고 있는 페이지, 최근 작업에 대한 컨텍스트를 유지합니다. 다음을 요청하십시오:
- 모든 대상 언어에 걸쳐 새 키에 대한 번역 생성
- 일관성과 정확성을 위한 기존 번역 검토
- 더 나은 번역 가능성을 위한 소스 텍스트 개선 제안
- 동기화 또는 구성에 문제가 발생했을 때 오류 설명
AI 드로어는 구성 가능한 LLM 제공자에 의해 구동됩니다. LLM 제공자 관리 인터페이스를 통해 OpenAI, Anthropic, Google 또는 다른 지원 제공자를 연결할 수 있습니다. 모델 기본 설정, 폴백 우선 순위 정의, 토큰 사용량 모니터링 — 모두 단일 설정 패널에서.
이 유연성은 단일 AI 공급업체에 종속되지 않음을 의미합니다. 대량 번역에는 GPT-4o를, 미묘한 검토에는 Claude를 사용하거나, 팀과 예산에 맞는 어떤 조합이든 구성하십시오.
개발자 도구 모달: 내부 가시성
개발 모드에서 개발자 도구 모달을 토글하여 다음을 확인합니다:
- API 호출 타이밍 — CDN 캐시 히트를 포함한 각 요청의 소요 시간
- 동기화 상태 — Zustand 스토어의 현재 상태 및 대기 중인 변경 사항
- 캐시 진단 — TTL 캐시 히트율 및 무효화 이벤트
- 구성 개요 — 활성 프로젝트 설정, SDK 버전, 연결 상태
이것은 플랫폼 동작을 이해하거나, 성능을 최적화하거나, 통합 문제를 디버깅하려는 엔지니어를 위해 구축되었습니다. 매일 사용하는 기능은 아니지만, 필요할 때 플랫폼에 내장되어 있으면 수 시간의 추측을 절약할 수 있습니다.
PostHog 분석 통합
Better i18n은 플랫폼 전반에 걸쳐 PostHog 이벤트 추적을 통합합니다. 이는 팀이 실제로 도구를 어떻게 사용하는지에 대한 정량적 인사이트를 제공합니다 — 어떤 기능이 가장 많은 가치를 창출하는지, 사용자가 어디에서 마찰을 경험하는지, 번역 속도가 시간이 지남에 따라 어떻게 변화하는지.
모든 분석 데이터는 귀하의 PostHog 인스턴스로 흐르므로, 데이터 개인 정보 보호 및 보존 정책에 대한 완전한 제어를 유지합니다.
이러한 선택의 철학
여기서 설명한 모든 기능은 단일 설계 원칙을 따릅니다: 의도와 행동 사이의 마찰을 줄이십시오. 명령 팔레트는 탐색 오버헤드를 제거합니다. 인라인 편집은 모달 오버헤드를 제거합니다. 자동 동기화는 저장 오버헤드를 제거합니다. AI 드로어는 컨텍스트 전환 오버헤드를 제거합니다.
현지화는 이미 충분히 복잡합니다 — 여러 언어, 문화적 뉘앙스, 기술적 제약, 팀 조율. 플랫폼은 복잡성을 흡수해야지 추가해서는 안 됩니다.
i18n 개발자 도구를 평가하거나 현재 번역 관리 플랫폼에서 전환을 고려하고 있다면, Better i18n을 사용해 보고 이러한 워크플로우를 직접 경험해 보시기 바랍니다. 개발자 경험은 사후에 추가한 기능이 아닙니다 — 그것은 다른 모든 것이 구축되는 기반입니다.
