Base44 앱을 현지화하려면 Base44가 제공하는 양방향 동기화로 GitHub에 연결하고, 번역 카탈로그를 해당 저장소에 커밋된 파일로 두면 돼요. Base44는 에디터와 저장소 사이의 모든 변경을 이미 서로 반영하므로, 로케일 파일이 main 브랜치에 올라가는 순간 앱의 일부가 돼요. globalize.now는 AI 기반 현지화 인프라예요. 키와 로케일 파일을 만들고, 프로젝트에 있는 런타임 라이브러리가 이를 서빙해요. 런타임 경로에 대시보드는 없고, 페이지가 로드된 뒤에 번역하는 것도 없어요.

Base44 앱이 영어로만 나오는 이유

UI 텍스트가 컴포넌트 안에 리터럴 문자열로 박혀 있기 때문이에요. Base44에 예약 페이지를 프롬프트로 요청하면 카탈로그를 조회하는 코드가 아니라 React 컴포넌트에 <h2>Your bookings</h2>를 그대로 써 넣어요. 제목, 버튼 레이블, 빈 상태 문구, 토스트, 유효성 검사 메시지가 모두 프롬프트에 쓴 언어 그대로 JSX에 들어가요.

Base44의 결함이 아니에요. 프롬프트 기반 빌더는 모두 이렇게 동작하고, Cursor가 하드코딩된 문자열을 계속 추가하는 문제에서 정리한 것과 같은 패턴이에요. 모델은 요청받은 내용에 맞는 가장 짧은 코드를 쓰는데, 로케일 레이어를 요청한 적은 없으니까요.

Base44에 "앱을 독일어로 번역해 줘"라고 요청해도 해결되지 않아요. 모델이 확인한 화면의 독일어 사본이 나오거나, 그 자리에서 임의로 만든 작은 strings 객체가 생겨요. 다음 프롬프트에서는 다시 영어로 새 텍스트를 써요. 텍스트가 카탈로그를 거쳐야 한다는 규칙이 프로젝트 어디에도 없으니까요.

Base44는 실제로 어떤 코드를 생성하나요?

Vite로 빌드한 표준 React 프로젝트예요. Base44 프로젝트 구조 문서를 보면 Code 탭과 연결된 저장소에서 다음 구조를 확인할 수 있어요. src/pages에는 라우트마다 파일이 하나씩 있어서 Home.jsx는 /가 되고 Settings.jsx는 /settings가 돼요. src/components에는 미리 만들어진 컴포넌트가 담긴 ui/ 폴더와 함께 재사용 가능한 요소가 있어요. src/api, src/hooks, src/lib, src/utils에는 SDK 클라이언트, 훅, 헬퍼가 있어요.

현지화에서는 두 디렉터리가 특히 중요해요. functions/에는 백엔드 로직이 함수당 TypeScript 파일 하나로 들어 있고, 이 파일들이 사용자가 읽는 텍스트(오류 응답, 이메일, 생성 문서)를 만들어요. entities/에는 데이터 모델이 JSON 스키마 파일로 들어 있는데, 양방향 동기화에서는 엔티티를 저장소가 아니라 Base44에서 관리해요.

즉 Base44 앱에는 카탈로그로 커버할 수 있는 문자열 영역이 React 클라이언트와 백엔드 함수 두 가지, 커버할 수 없는 영역이 엔티티 안의 데이터 한 가지 있어요. 마지막 영역은 아래에서 다시 다뤄요.

Base44 앱을 저장소에 올리려면 어떻게 하나요?

Base44가 연결 기능을 기본 제공해요. 에디터에서 Dashboard를 열고 GitHub 아이콘을 클릭한 뒤 연결하세요. GitHub 계정이나 조직에서 Base44 Builder 앱을 승인하고, 접근을 허용할 저장소를 고르고, 앱용 새 저장소를 만들어요. 그 뒤로는 저장소와 에디터가 양방향으로 계속 일치해요.

Base44 문서의 두 가지 규칙이 이후 과정을 좌우해요. 첫째, 동기화는 자동이에요. Base44에서 한 변경은 프롬프트로 AI가 만든 변경까지 포함해 푸시 단계 없이 저장소에 커밋되고, 수동으로 푸시하는 버튼은 없어요. 둘째, 반대 방향은 main 브랜치를 통해요. main에 머지한 내용은 Base44 앱에 반영되고, master이나 다른 기본 브랜치 이름은 지원하지 않아요. 머지한 뒤에 Publish를 클릭하면 새 버전이 사용자에게 배포돼요.

양방향 동기화는 Builder 요금제 이상이 필요하고, 최초 연결은 앱 소유자만 할 수 있어요. 계정에서 예전 단방향 Export to GitHub 연동을 설정했다면 GitHub 패널의 링크로 연결을 해제한 뒤 양방향 동기화로 다시 연결하세요. 단방향 방식은 에디터로 아무것도 되돌려 보내지 않는데, 현지화에는 바로 그 방향이 필요해요.

로컬에서 작업하려면 저장소를 클론하고 npm install를 실행한 뒤 Base44 CLI를 설치하세요. 그다음 base44 login와 base44 link로 클론을 해당 앱에 연결해요. base44 dev는 로컬 백엔드를 대상으로 프런트엔드를 실행해요. 로컬 브랜치를 main에 머지하면 다시 동기화돼요.

Base44 앱에서 "대시보드 없이"는 무슨 뜻인가요?

번역된 문자열이 앱이 호출해야 하거나 내보내기를 해야 하는 호스팅 서비스에 있지 않다는 뜻이에요. 문자열은 src/locales/de.json에 있고 src/pages/Home.jsx 바로 옆에서, 같은 커밋으로 버전 관리되고, 같은 PR로 리뷰되고, 같은 Publish 클릭으로 배포돼요.

다른 방식은 Base44에서 각각 비용이 따라요. 브라우저에서 페이지를 번역하는 런타임 위젯은 소스를 건드리지 않아서 저장소에는 여전히 영어 앱으로 남고, 모든 방문자가 로드할 때마다 번역 지연을 겪어요. 자체 에디터가 있는 호스팅 번역 도구는 기준 데이터를 저장소 밖에 두기 때문에, Base44가 만든 양방향 동기화는 언어가 들어 있지 않은 코드베이스를 동기화하는 셈이 돼요. 두 방식 모두 이미 내 소유 파일에 있는 텍스트와 나 사이에 시스템을 하나 더 끼워 넣어요.

저장소 네이티브 방식은 동기화를 설계된 그대로 활용해요. 카탈로그는 파일이고, 파일은 커밋되고, 커밋된 파일은 main에 도달하고, main은 에디터에 반영돼요. 이게 파이프라인의 전부이고, 어느 것도 현지화 전용이 아니에요.

저장소 네이티브 방식은 어떻게 동작하나요?

앱에서 저장소를 연결하고 변환을 한 번 실행하세요. 변환 과정에서 컴포넌트와 백엔드 함수의 리터럴 문자열을 찾아 키를 붙이고, 프로젝트에 없다면 i18next나 Lingui 같은 런타임 라이브러리를 연결해요. 그리고 소스 카탈로그와 초기 대상 언어들을 담은 PR을 저장소에 열어요. 이 PR이 인계의 전부예요. 다른 변경처럼 GitHub에서 리뷰하고 main에 머지하면 Base44가 에디터에 반영해요.

이후에는 푸시 작업이 새 카탈로그 항목을 번역해요. Base44에 새 기능을 프롬프트로 요청해 동기화로 커밋되면, 소스 카탈로그의 새 키가 번역되어 PR로 전달돼요. 머지하고 Publish를 클릭하면 기능이 모든 언어로 배포돼요. 프롬프트 습관을 바꿀 필요가 없고, 앱이 런타임에 외부 서비스를 호출하지도 않아요.

같은 방식이 Lovable, Bolt, v0, Replit에서도 동작해요. 네 곳 모두 일반적인 프런트엔드 프로젝트를 주기 때문에 원리가 같아요. 카탈로그 구조는 Lovable 단계별 안내에 가장 자세히 나와 있고, 네이티브 동기화가 없는 빌더의 내보내기 단계는 Bolt 가이드에서 다뤄요. 코드 수준에서 Base44의 React와 Vite 출력과 가장 비슷한 건 Lovable 클래식 스택용 Vite 가이드예요. 빌더를 하나로 정하지 않고 비교하는 중이라면 vibe coder 개요에서 시작하는 편이 좋아요.

백엔드 함수에는 어떤 문자열이 있나요?

서버에서 만들어져 사용자가 읽는 텍스트는 모두 해당돼요. 함수가 반환하는 유효성 검사 오류, 발송하는 이메일의 제목, 생성하는 PDF의 본문, 알림 텍스트 같은 것들이에요. 이런 문자열은 JSX에 나오지 않기 때문에 프런트엔드 카탈로그에는 없고, 런타임 위젯도 볼 수 없어요.

패턴은 클라이언트와 같아요. 들어온 요청에서 요청된 로케일을 읽고, 함수 쪽에서 해당 로케일의 카탈로그를 불러오고, 키 네임스페이스를 클라이언트와 공유해요. 그러면 같은 메시지가 UI와 API 응답에서 같은 의미를 가져요. functions/ 디렉터리도 저장소에 있어서, 변환은 이 파일들을 다른 소스와 똑같이 처리하고 카탈로그를 옆에 둬요.

엔티티 안의 콘텐츠는 어떻게 하나요?

여기가 Base44만의 경계예요. 엔티티는 Base44 안에서 관리하는 데이터 모델이고, 양방향 동기화에서는 저장소에 포함되지 않아요. 상품명, 서비스 설명, 도움말 문서 같은 레코드는 UI 텍스트가 아니라 데이터이고, 어떤 카탈로그에도 담기지 않아요.

데이터 콘텐츠에는 엔티티 자체에 언어 차원이 필요해요. locale 필드를 두거나 언어별로 필드를 하나씩 두고, 방문자의 로케일을 읽는 쿼리를 작성하세요. Lovable 앱의 데이터베이스 콘텐츠에서 설명한 것과 같은 구성이고, 현지화 도구가 아니라 Base44 엔티티 에디터에서 정하는 데이터 모델 결정이에요. 일찍 계획하세요. 레코드가 이미 있는 엔티티에 언어 필드를 나중에 붙이는 건 새 엔티티에 넣는 것보다 훨씬 번거로워요.

Lovalingo를 쓰고 있었다면 어떻게 하나요?

Lovalingo는 2026년 8월 말에 서비스를 종료했고, 공개된 사용 사례에는 Lovable, v0, Bolt와 함께 Base44도 포함되어 있었어요. Lovalingo로 Base44 앱을 현지화했다면 그 문자열을 옮겨 둘 곳이 필요해요. 새로 설정하는 게 아니라 마이그레이션이에요. 먼저 내보내고, 그다음 변환하세요. 마이그레이션 가이드에서 과정을 안내하고, 번역을 호스팅 서비스에서 내 저장소로 옮길 때 무엇이 달라지는지는 비교 페이지에서 다뤄요.

두 번째 언어를 추가하기 전에 무엇을 확인해야 하나요?

동기화가 예전 내보내기 방식이 아니라 양방향인지 확인하세요. Base44의 GitHub 패널을 열어 저장소가 연결됨으로 표시되는지 보세요. "Looking for the old setup?" 링크가 보인다면 단방향 방식이니 다시 연결해야 해요.

기본 브랜치가 main인지 확인하세요. Base44는 이 브랜치만 에디터로 되돌려 반영하기 때문에, 다른 브랜치에 머지한 PR은 에디터에 도달하지 않아요.

런타임 라이브러리가 있는지 확인하세요. 중간에 Base44에 언어 지원을 요청했다면 i18next나 직접 만든 컨텍스트가 추가됐을 수 있어요. 변환은 기존 구성을 유지하고 거기에 맞춰 연결해요.

두 번째 언어로 레코드를 추가하기 전에 엔티티 콘텐츠의 언어 필드를 어디에 둘지 정하세요. 이 부분은 카탈로그가 대신해 주지 않아요.

라우팅을 확인하세요. Base44 페이지는 파일 기반이라서 URL의 로케일 접두사는 한 번 정하는 라우팅 결정이고, 검색 엔진이 각 언어를 어떻게 인식하는지에 영향을 줘요. 언어 전환기와 hreflang 가이드에서 선택지를 다루는데, 그대로 적용할 수 있어요.

시작하는 방법

아직 켜지 않았다면 Base44에서 GitHub 양방향 동기화를 켜고, 브랜치가 main인지 확인한 뒤 앱에서 저장소를 연결하세요. 첫 번째 PR이 코드베이스를 변환해요. 그 이후는 머지, Publish 클릭, 그리고 요청한 언어가 전부예요. 에디터 안에서 바로 연동할 수 있는 빌더의 같은 흐름은 Lovable 연동 페이지에 설명되어 있고, 거기 내용 대부분은 Base44에도 그대로 적용돼요.

globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.

globalize.now 무료로 시작하기