아니요, 번역 PR이 Lovable이 동기화하는 브랜치 하나로 머지되기만 한다면 Lovable의 GitHub 동기화를 망가뜨리지 않아요. Lovable은 한 번에 브랜치 하나만 편집하고, 머지된 커밋을 프로젝트로 다시 가져와요. 번역 PR도 그 브랜치에 들어오는 커밋 중 하나일 뿐이에요. globalize.now는 AI 기반 현지화 인프라로, 번역을 저장소에 대한 PR로 전달해요. 두 시스템은 일반적인 Git 머지에서만 만나고, 그 외에는 접점이 없어요. 문제가 생기는 경우는 정해져 있고 문서로도 정리돼 있어요. 이 글에서 하나씩 살펴볼게요.
Lovable의 GitHub 동기화는 실제로 어떻게 동작하나요?
양방향이고, 브랜치 하나만 대상으로 해요. Lovable 문서에 따르면 한 번에 브랜치 하나만 수정하고 동기화하며, 기본값은 저장소의 기본 브랜치(보통 main)예요. Lovable에서 한 변경은 그 브랜치에 커밋돼요. GitHub에서 그 브랜치로 푸시한 커밋은 Lovable로 다시 반영돼요.
Lovable 밖에서 저장소에 쓰는 작업이라면 두 가지를 알아야 해요.
가져오기는 알림에 의존해요. Lovable은 GitHub에서 푸시 알림을 받아 프로젝트를 업데이트해요. 같은 문서에 따르면 이 알림이 도착하지 않으면 해당 푸시의 커밋은 Lovable에 나타나지 않아요. 문서가 안내하는 해결책은 커밋을 하나 더 푸시해서 새 알림을 발생시키는 거예요. 번역 PR을 머지했는데 에디터에 여전히 영어가 보인다면 가장 먼저 이 부분을 확인하세요.
동기화 브랜치를 바꿀 수 있어요. 프로젝트의 GitHub 설정에는 브랜치 선택기가 있어요. 여기서 만든 브랜치는 자동으로 main에서 갈라지는 게 아니라 현재 활성화된 브랜치에서 갈라져요. 브랜치를 바꾸면 Lovable은 그 브랜치를 수정하고 동기화해요. 이후 main에 머지한 내용은 Lovable이 사용 중인 브랜치에 머지하기 전까지 에디터에서 보이지 않아요.
이 섹션에서 한 문장만 기억한다면 이거예요. 번역 PR은 선택기에 표시된 브랜치로 들어가야 해요.
GitHub가 Lovable의 푸시를 거부하면 어떻게 되나요?
Lovable은 변경 내용을 잃지 않고 lovable-sync라는 브랜치에 보관해요. Lovable 문서에 따르면 충돌이나 브랜치 보호 규칙 때문에 GitHub가 푸시를 거부할 때 이렇게 동작해요. 그다음 평소 리뷰 절차로 lovable-sync를 보호된 브랜치에 머지하면 돼요.
관련된 안전장치도 있어요. Lovable이 동기화 중인 브랜치를 GitHub에서 삭제하면 프로젝트는 lovable-fallback라는 새 브랜치로 전환돼요. 저장소 자체를 삭제하면 연결이 끊어지고 동기화가 멈추지만, 저장소 이름을 바꾸는 건 영향이 없어요.
이 중 번역에만 해당하는 내용은 없어요. Lovable 곁에서 두 번째로 쓰는 쪽이 어떻게 동작해야 하는지에 대한 이야기고, 번역 PR은 예의 바른 두 번째 작성자예요. 리뷰할 수 있는 PR로 도착하고, 보호된 브랜치에 바로 푸시하지 않아요.
번역 PR은 어느 단계에 들어가나요?
Lovable의 커밋과 머지 버튼 사이예요. lovable-i18n skill이 이미 설치돼 있고 Lovable knowledge의 지침 규칙으로 새 문자열을 계속 감싸게 한 Lovable 프로젝트에서는 흐름이 이렇게 돼요.
- Lovable이 기능을 작성하면서 새 문자열을 Lingui 매크로로 감싸요. 그리고 동기화 브랜치에 커밋해요.
- GitHub 워크플로가 감싼 문자열을
src/locales/아래 PO 카탈로그로 추출하고, 동기화 결과를 다시 커밋해요. Lovable에는 터미널이 없어서 추출은 에디터가 아니라 GitHub에서 실행해야 해요. - 변환은 앱에서 한 번만 하면 돼요. 저장소를 연결하면 globalize.now가 코드베이스를 한 번 변환하고, 카탈로그를 PR로 전달해요. 그 후에는 푸시 작업이 새 카탈로그 단위를 번역하고, 번역된 카탈로그도 PR로 전달해요.
- PR을 동기화 브랜치에 머지하세요. Lovable이 머지 커밋을 가져오면 앱에 새 언어가 바로 표시돼요.
없는 것들을 눈여겨보세요. Lovable의 가져오기 단계도, 웹 대시보드에서 내보내기도, 런타임에 번역을 불러오는 위젯도 없어요. 번역된 파일은 저장소 안의 일반 파일이에요. 이게 바로 대시보드 없이 Lovable 앱 현지화하기의 핵심 논거예요. 정확한 연결 방법은 Lovable 연동 페이지에서 볼 수 있어요.
Lovable과 번역 PR이 충돌할 수 있나요?
네, 일반적인 Git 방식으로는 충돌할 수 있어요. 다만 PR을 짧게 유지하면 드물어요. 충돌은 브랜치를 만든 시점부터 머지하기까지 두 작성자가 같은 파일의 같은 줄을 바꿨을 때만 생겨요.
현실적으로 겹칠 수 있는 곳은 PO 카탈로그뿐이에요. Lovable이 문자열을 추가하면 각 src/locales/*/messages.po 끝에 번역이 빈 새 메시지를 덧붙이고, 앱은 원문으로 대체해서 보여줘요. 번역 PR은 PR을 열 때 이미 카탈로그에 있던 메시지의 번역문을 채워요. PR이 같은 파일의 앞쪽 항목을 수정하는 동안 Lovable이 파일 끝에 새 메시지를 덧붙이면 Git은 아무 문제 없이 둘 다 머지해요. 둘이 같은 항목을 건드렸을 때만 충돌 마커가 생겨요.
세 가지 습관으로 이 구간을 작게 유지할 수 있어요.
번역 PR은 열린 날 바로 머지하세요. PR을 일주일 동안 방치하는 사이 Lovable이 기능을 열 개 배포하는 경우에만 상황이 복잡해져요.
카탈로그 항목의 참조 주석은 직접 수정하지 마세요. 추출 워크플로가 #.와 #: 줄을 다시 생성해요. 충돌을 해결할 때는 번역문이 있는 항목을 남기고, 주석은 다음 추출 실행이 다시 쓰게 두세요.
머지 전에 뒤처진 브랜치를 먼저 따라잡으세요. PR 브랜치가 뒤처졌다면 먼저 업데이트하세요:
git fetch origin
git checkout <translation-branch>
git merge origin/<synced-branch>
Git이 표시한 충돌을 해결하고, 푸시한 뒤, 머지하세요. 카탈로그는 텍스트이고 메시지마다 블록으로 나뉘어 있어서, 해결할 충돌은 대부분 파일 전체가 아니라 항목 하나예요.
브랜치 보호는 무엇을 바꾸나요?
리뷰가 추가돼요. 그런데 리뷰는 이미 기본 모델이에요. PR로 전달되는 번역은 브랜치에 설정된 필수 검사와 승인을 그대로 거쳐요. 보호된 브랜치가 거부한 Lovable의 푸시는 lovable-sync에 도착하고, 같은 리뷰를 거쳐 머지하면 돼요. 두 경로는 분리돼 있어서 서로 막지 않아요.
기본 브랜치를 보호하면서 Lovable이 그 브랜치를 수정하게 두면 lovable-sync를 주기적으로 머지해야 해요. 이건 Lovable 문서에 명시된 동작이지 번역 문제가 아니에요. 번거롭다면 Lovable 작성자에 대한 보호 규칙을 완화하거나, 프로젝트 설정에서 동기화 브랜치를 전용 브랜치로 바꾸면 돼요. 어느 쪽이든 번역 PR은 Lovable이 동기화하는 브랜치를 대상으로 하세요.
런타임 번역 위젯에서는 왜 이런 문제가 없었나요?
저장소에 아무것도 쓰지 않았기 때문이에요. 2026년 8월 31일에 서비스를 종료한 Lovalingo는 브라우저에서 렌더링된 페이지를 번역했어요. 그래서 저장소에는 로케일 파일도, 머지할 PR도 없었어요. 마이그레이션 가이드로 커밋된 카탈로그 방식으로 옮긴 팀은 Lovable의 GitHub 동기화를 처음으로 작성자가 둘인 시스템으로 마주하게 돼요.
이게 맞바꾸는 조건이고, 올바른 선택이에요. 번역문이 렌더링 시점에 빌려 쓰는 게 아니라 내 것이 되고, 버전 관리와 색인이 가능해져요. 대신 Lovable이 어느 브랜치에 있는지는 알아야 해요. Lovable 앱의 번역을 유지하는 나머지 절반, 즉 카탈로그가 코드를 따라가지 못하는 문제는 배포할 때마다 번역이 깨지는 이유를 참고하세요. 앱이 데이터베이스에도 콘텐츠를 저장한다면 그 계층은 저장소 밖에 있어요. Lovable 앱의 데이터베이스 콘텐츠 현지화에서 다뤄요.
두 작성자를 한 브랜치에 두세요
프로젝트 GitHub 설정의 브랜치 선택기를 확인하고, 번역 PR을 그 브랜치로 머지하세요. lovable-sync는 오류가 아니라 할 일 목록으로 보면 돼요. Lovable로 만들면서 번역 작업을 직접 관리하는 대신 맡기고 싶다면 vibe coder 페이지에서 개요를 볼 수 있고, 요금은 별도 페이지에 있어요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기