Replit 앱을 다국어로 만들려면 Git 저장소를 GitHub에 연결하고, 번역 카탈로그를 그 저장소에 커밋된 파일로 두세요. Replit은 이미 모든 Agent 체크포인트를 Git 커밋으로 저장하기 때문에, 언어를 고민하기 전에도 저장소는 존재해요. 할 일은 저장소를 GitHub에 올리고, 카탈로그가 같은 히스토리로 돌아오게 하는 거예요. globalize.now는 AI 기반 현지화 인프라로, 키와 로케일 파일을 만들고 앱이 이미 쓰는 런타임 라이브러리가 이를 서비스해요. 런타임 경로에 대시보드는 없고, 페이지가 로드된 뒤에 번역하는 것도 없어요.
Agent에게 앱을 번역해 달라고 하면 왜 안 되나요?
번역을 넣을 곳이 없기 때문이에요. Replit Agent에게 대시보드를 만들어 달라고 하면 카탈로그를 조회하는 코드가 아니라 <h2>Your bookings</h2> 같은 텍스트를 컴포넌트에 그대로 써요. 모든 제목, 버튼, 빈 상태, 토스트, 검증 오류가 프롬프트를 입력한 언어의 리터럴로 JSX에 들어가요.
그래서 나중에 Agent에게 "앱을 아프리칸스어로 번역해 줘"라고 하면 반쪽짜리 결과 둘 중 하나가 나와요. 텍스트만 바꾼 컴포넌트 사본이 하나 더 생기거나, Agent가 우연히 본 화면만 담은 translations 객체를 직접 만들어 줘요. 둘 다 로케일 레이어가 아니에요. 그래서 다음 기능은 다시 영어로 나와요. Cursor가 계속 하드코딩된 문자열을 추가하는 문제에서 같은 현상을 정리했는데, Replit Agent도 다르지 않아요. 뒤에 있는 아키텍처가 아니라 눈앞의 프롬프트를 풀기 때문이에요.
해결책은 구조를 바꾸는 거예요. 문자열에 키를 붙이고, 번역을 파일에 넣고, 런타임이 그 파일을 읽게 하세요. 코드베이스에서 "다국어"란 바로 이런 구조를 뜻하고, 한 번만 바꾸면 돼요.
Replit Agent는 실제로 무엇을 만들어 주나요?
기존 방식의 웹 프로젝트예요. 이건 좋은 소식이에요. Replit이 엄선해 둔 앱 유형은 프런트엔드에 ShadCN UI를 쓰는 React 기반이고, 보통 같은 프로젝트에 Express 서버가 함께 구성되며 전부 TypeScript로 작성돼요. 2025년 9월부터는 Agent가 가져온 GitHub 저장소를 포함해, 사용자가 가져오는 어떤 프레임워크로도 작업할 수 있어서 Next.js나 Vue 프로젝트도 가능해요. 다만 기본 경로는 여전히 React 스택이에요.
현지화에서는 스택이 가장 중요한 사실이고, 이 스택은 표준적인 환경이에요. React, Vite, TypeScript는 i18n 생태계에서 가장 폭넓게 지원되는 조합이라 i18next, Lingui, react-intl이 모두 직접 지원해요. Agent가 Next.js 앱을 만들었다면 next-intl, react-i18next, Lingui 중에서 고르게 되는데, 그 비교는 별도 글에서 다뤄요.
프런트엔드 전용 빌더와 다른 점은 프로젝트의 나머지 절반이에요. Replit 앱에는 보통 서버가 있고, 서버에도 문자열이 있어요. 자세한 내용은 아래에서 다뤄요.
Replit 앱에서 Git 저장소는 어디에 있나요?
이미 있어요. Replit의 버전 관리는 내부적으로 Git이고, Agent 체크포인트는 그 저장소의 커밋이에요. Agent가 기능을 끝내고 롤백 지점을 제안할 때마다 커밋이 만들어진 거예요. Replit 공식 문서도 외부 저장소와 작업할 때는 장기 추적을 위해 일반 Git 커밋으로 전환하라고 권장하는데, 지금이 바로 그 상황이에요.
GitHub에 올리는 방법은 다음과 같아요.
- 프로젝트 에디터의 Tools 섹션에서 Git 도구를 추가하세요.
- 연결된 서비스에서 GitHub 계정을 연결한 뒤, Git 패널에서 저장소를 연결하세요. 프로젝트가 한 번도 초기화된 적이 없다면 패널이 먼저 초기화를 제안해요.
- 푸시하세요. 패널에서 클릭 한 번으로 푸시할 수 있고, Shell에서 실행하는 작업과도 계속 동기화되므로
git push origin main도 그대로 동작해요.
Replit은 GitLab과 Bitbucket도 지원하고, 같은 흐름이 적용돼요. 중요한 건 어떤 서비스를 쓰느냐가 아니라, 현지화 작업이 풀 리퀘스트를 열 수 있는 곳에 저장소가 있다는 점이에요.
문자열을 하나라도 건드리기 전에 이 작업부터 하세요. 현지화는 파일 작업이고, diff는 그 결과를 리뷰하기에 알맞은 곳이에요.
Replit 앱에서 "대시보드 없이"는 무슨 뜻인가요?
번역된 문자열이 저장소의 파일이고, 앱이 다른 에셋처럼 그 파일을 서비스한다는 뜻이에요. script 태그도, 페이지 로드 시 외부 fetch도 없고, 방문자와 내 콘텐츠 사이에 벤더 계정이 끼어들지도 않아요.
대안은 페이지가 렌더링된 뒤에 텍스트를 바꿔치기하는 런타임 위젯이에요. 이 방식의 비용은 구조적이에요. 첫 렌더링은 영어이고, 번역된 콘텐츠는 크롤러가 가장 먼저 읽는 HTML에 없고, 서드파티 스크립트가 프로덕션 경로에 놓이고, 문자열이 벤더의 저장소에 있어서 떠나려면 내보내기를 해야 해요. Lovable에서 같은 논의를 다룬 대시보드 없이 Lovable 앱 현지화하기는 Replit에도 그대로 적용돼요.
Replit에서 이게 더 중요한 이유가 하나 있어요. Replit이 앱을 대신 배포해 주기 때문에, Replit 도메인에서 실행되는 사본은 배포 시점에 프로젝트에 있던 내용 그대로예요. 위젯은 그 배포본을 바깥에서 번역할 뿐이에요. 카탈로그가 저장소에 있으면 배포본에 이미 모든 언어가 들어 있고, 배포하기 전에 Replit 미리보기에서 독일어 버전을 확인할 수 있어요.
트레이드오프는 분명히 있어요. 문구를 바꾸려면 저장 버튼이 아니라 커밋과 재배포가 필요해요. Replit에서 혼자 배포하는 빌더에게는 별일 아니지만, 프로젝트를 건드리지 않고 라이브 문구를 수정하길 기대한다면 제약이 돼요.
저장소 네이티브 방식은 어떻게 동작하나요?
globalize.now 앱에서 저장소를 연결하세요. 변환은 코드베이스에 대해 한 번만 실행돼요. 하드코딩된 문자열은 키가 있는 카탈로그 단위가 되고, 컴포넌트는 리터럴 대신 런타임 라이브러리에서 값을 읽기 시작해요. 한 번 하는 작업이라 나중에 다시 실행되지 않아요.
변환이 끝나면 앱이 커질 때마다 푸시 작업이 새 카탈로그 단위를 번역해요. Agent에게 새 설정 페이지를 요청하고 푸시하면 새 단위만 번역되고 기존 단위는 그대로예요. 카탈로그는 런타임 라이브러리에 따라 JSON이나 PO 파일로 커밋되어, 다른 변경과 똑같이 리뷰하는 PR로 돌아와요.
경계가 두 가지 있어요. 이 분야는 헷갈리기 쉬워서요. globalize.now는 런타임 라이브러리를 대체하지 않아요. i18next, Lingui, next-intl이 계속 자기 역할을 해요. 또 DeepL과 경쟁하는 번역 엔진도 아니에요. 키와 로케일 파일을 만드는 중간 레이어예요. 동작 방식은 개발자 개요에서 볼 수 있어요.
번역은 어떻게 Replit으로 돌아오나요?
같은 Git 패널을 반대 방향으로 쓰면 돼요. Replit은 앱이 실행되는 곳이기도 해서 Bolt나 Lovable과 다른 단계예요.
- GitHub에서 PR을 리뷰하고 머지하세요.
- Replit Git 패널에서 Pull을 선택하세요. 그동안 나나 Agent가 같은 파일을 바꿨다면 패널이 충돌을 표시하고, 머지를 마치기 전에 에디터에서 해결하면 돼요.
- 다시 배포하세요. 카탈로그가 이제 프로젝트의 일부라서 배포본에 모든 언어가 들어 있어요.
Replit에만 해당하는 주의점이 하나 있어요. Agent 체크포인트는 파일을 포함한 프로젝트 전체 상태를 복원해요. 번역 브랜치를 pull하기 전에 만든 체크포인트로 롤백하면 카탈로그도 함께 사라져요. 머지를 하나의 마일스톤으로 보고, 머지 후에 Agent가 체크포인트를 만들게 한 다음, 그 이전이 아니라 그 체크포인트로 롤백하세요.
서버에는 어떤 문자열이 있나요?
프런트엔드가 JSX로는 접하지 않는 문자열들이에요. Express 백엔드가 있는 Replit 앱에는 두 번째 문자열 영역이 있어요. API 오류 메시지, 검증 응답, 이메일 제목, 알림 본문, CSV 헤더 등 서버가 보내기 전에 만드는 모든 텍스트예요. 프런트엔드 카탈로그는 여기에 닿지 않고, 위젯은 이런 문자열이 DOM에 전혀 나타나지 않으므로 아예 볼 수 없어요.
클라이언트와 같은 패턴을 서버 쪽에 적용하면 돼요. 서버에 런타임 라이브러리 사본을 두고, 요청에서 방문자의 로케일(Accept-Language 헤더나 사용자 레코드의 locale 필드)을 읽어서, 문자열 리터럴 대신 카탈로그를 바탕으로 응답을 구성하세요. 키 네임스페이스는 클라이언트와 공유하므로, errors.booking.overlap 키는 토스트에서든 409 응답에서든 같은 뜻이에요.
이 단계를 건너뛰면 첫 에러가 나기 전까지는 다국어 앱처럼 보이다가, 에러가 나는 순간 영어로 응답해요.
두 번째 언어를 추가하기 전에 무엇을 확인해야 하나요?
변환 전에 아래 항목을 점검하세요. 다섯 개 언어 작업이 진행 중인 뒤보다 지금 고치는 편이 각 항목마다 훨씬 쉬워요.
- 문자열 이어 붙이기.
"Welcome back, " + user.name는 번역가가 어순을 바꿀 수 없어요. 대신 보간을 쓰세요. - 복수형. 영어는 형태가 두 가지지만 폴란드어는 세 가지, 아랍어는 여섯 가지예요.
count === 1에 삼항 연산자를 쓰는 방식은 대부분의 언어에서 틀려요. - 날짜, 숫자, 통화. 클라이언트와 서버 모두 문자열 포맷팅 대신
Intl를 쓰세요. - 레이아웃. 독일어와 핀란드어는 영어보다 길어요. 고정 너비 버튼은 깨지고, Tailwind 클래스는 번역 텍스트가 들어오기 전까지는 멀쩡해 보여요.
- 오른쪽에서 왼쪽(RTL). 아랍어나 히브리어가 로드맵에 있다면 지금 정하세요. 나중에 RTL을 끼워 넣는 게 가장 비싸요.
- 카탈로그 드리프트. 카탈로그가 생기면 한 로케일에만 추가된 키는 조용한 버그가 돼요. 번역 파일이 동기화에서 벗어나는 이유에서 어떻게 발생하는지, 푸시 잡이 이를 어떻게 막는지 다뤄요.
사용자 수, 언어 수, 프로젝트 수에 따른 요금이 없어서, 언어를 몇 개로 할지는 예산이 아니라 제품 결정이에요. 현재 요금은 요금 페이지에서 확인하세요. 다른 빌더에서 같은 과정을 보고 싶다면 vibe coder 개요에서 시작하세요.
시작하는 방법
Replit 프로젝트가 이미 GitHub에 연결돼 있다면, 다음 단계는 도구 선택이 아니라 그 저장소에 대한 변환이에요. 아직 연결하지 않았다면, 먼저 Git 패널에서 연결부터 하세요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기