기존 Vite 스택으로 만든 Lovable 앱을 현지화하는 가장 좋은 방법은 런타임 번역 위젯을 덧붙이는 게 아니라, 하드코딩된 문자열을 커밋되는 Lingui PO 카탈로그로 추출하는 거예요. Lovable 앱은 클라이언트에서 렌더링하는 React SPA라서 연결할 서버 렌더링이 없어요. 지속 가능한 방법은 내 저장소에 두고 빌드와 함께 배포되는 번역 파일이에요. globalize.now는 AI 기반 현지화 인프라로, 추출을 맡고 Git 푸시마다 카탈로그를 동기화해요. 한 번만 설정하면 로케일 파일을 직접 관리할 일이 없어요.


내 Lovable 앱은 기존 Vite 스택인가요, TanStack Start인가요?

먼저 파일 트리를 열어 보세요. Lovable은 두 가지 스택을 제공하고, 스택마다 i18n 설정이 달라요. src/pages/Index.tsx, src/main.tsx, vite.config.ts가 있다면 Lovable의 기본 스택인 기존 Vite + React SPA 스택이에요. TanStack Start 프로젝트에는 대신 src/routes/, src/router.tsx, src/routeTree.gen.ts, src/server.ts가 있어요.

스택은 프로젝트를 만들 때 정해지고 나중에 바꿀 수 없으니, 이미 결정된 사항이에요. 기존 Vite 스택은 전부 브라우저에서 렌더링하고, 기본적으로 서버 측 데이터 페칭을 하지 않아요. 이 가이드는 기존 Vite SPA를 다뤄요. 파일 구조가 TanStack Start와 같다면 서버 렌더링 때문에 번역 로딩 방식이 달라지므로, Lovable용 TanStack Start i18n 가이드를 대신 따르세요.


Vite SPA 기반 Lovable 앱은 왜 i18n 도구에서 소외되나요?

도구들의 관심이 Lovable의 새 기본 스택인 TanStack Start + SSR로 옮겨 가면서, 여전히 가장 흔한 스택인 기존 Vite SPA는 지원이 부족해졌기 때문이에요. 최근 몇 달 사이 Lovable을 겨냥한 현지화 도구들, 즉 Lovalingo, Intlayer, Paraglide는 모두 가이드를 서버 사이드 렌더링을 쓰는 TanStack Start 기준으로 바꿨어요.

여기에 공백이 남아 있어요. 클라이언트 렌더링 SPA에는 SSR 가이드가 무시하는 현실적인 제약이 있어요. 번역된 마크업을 주입할 서버 렌더링이 없고, 번들 전체가 브라우저에서 로드되며, 늦게 로드되는 스크립트는 영어 UI 위에 덧칠하게 돼요. 다행히 기존 스택에는 깔끔하고 잘 지원되는 해법이 있어요. 가장 시끄러운 도구들이 다른 스택을 쫓느라 바빠서 대부분의 개발자가 그 해법을 들어 보지 못했을 뿐이에요.


커밋된 카탈로그와 런타임 번역 위젯은 무엇이 다른가요?

커밋된 카탈로그는 저장소에 체크인되어 빌드 시점에 번들에 포함되는 번역 파일이에요. 런타임 위젯은 영어 UI가 이미 로드된 뒤에 브라우저에서 텍스트를 교체하는 서드파티 스크립트고요. 이 차이가 Vite SPA에서 중요한 세 가지를 좌우해요.

첫째는 깜빡임과 레이아웃 이동이에요. 위젯은 영어를 먼저 보여 준 뒤 다시 쓰기 때문에 사용자에게 텍스트가 바뀌는 게 보이고 레이아웃이 튈 수 있어요. 커밋된 카탈로그는 첫 페인트부터 알맞은 언어로 렌더링해요. 둘째는 색인 가능성이에요. 빌드에 포함된 문자열은 소스의 일부지만, 위젯 텍스트는 늦게 주입되어 크롤러가 읽기 어려워요. 셋째는 소유권이에요. 커밋된 카탈로그는 내 저장소에 있는 내 파일이라, 앱이 독일어나 일본어를 계속 지원하는 데 외부 서비스가 살아 있을 필요가 없어요.


Lingui로 Lovable Vite 앱에 i18n을 추가하려면 어떻게 하나요?

Lingui를 i18n 레이어로 추가하고, 문자열을 감싼 뒤, Vite 플러그인이 카탈로그를 컴파일하게 하세요. Lingui는 전용 Vite 플러그인과 PO 기반 카탈로그 형식을 갖춘 가벼운 i18n 프레임워크로, 클라이언트 렌더링 SPA에 딱 맞아요.

먼저 패키지를 설치하세요. Lingui는 CLI, Vite 플러그인, React 런타임이 나뉘어 있어요.

npm install --save-dev @lingui/cli @lingui/vite-plugin @rolldown/plugin-babel
npm install @lingui/core @lingui/react

다음으로 vite.config.ts에 플러그인을 등록하고, 소스와 locales 폴더를 가리키는 lingui.config.ts를 추가하세요.

// vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import { lingui } from "@lingui/vite-plugin";

export default defineConfig({
  plugins: [react(), lingui()],
});
// lingui.config.ts
import { defineConfig } from "@lingui/cli";

export default defineConfig({
  locales: ["en", "de", "fr"],
  sourceLocale: "en",
  catalogs: [
    {
      path: "src/locales/{locale}/messages",
      include: ["src"],
    },
  ],
});

그런 다음 하드코딩된 JSX 텍스트를 그대로 두지 말고 Trans 매크로로 감싸세요.

// before
<h1>Create your account</h1>

// after
import { Trans } from "@lingui/react/macro";
<h1><Trans>Create your account</Trans></h1>

이제 추출해요. CLI가 src 디렉터리를 스캔해 로케일별 PO 카탈로그를 써요. 예를 들면 src/locales/en/messages.po예요.

npx lingui extract

언어별로 msgstr 필드를 채우거나, 이 단계를 자동화 레이어에 맡기세요(다음 섹션 참고). 개발과 빌드 중에 @lingui/vite-plugin이 PO 카탈로그를 즉시 컴파일하므로 별도의 컴파일 명령은 실행하지 않아도 돼요.

마지막으로 런타임에 로케일을 활성화해서 언어 전환 기능을 추가하세요.

import { i18n } from "@lingui/core";
i18n.activate("de");

기존 Vite 스택에서는 이게 전체 흐름이에요. 설치, 감싸기, 추출, 번역, 전환. 번역 자체를 제외한 모든 것이 내 저장소 안에 있어요.


globalize.now는 푸시마다 이 과정을 어떻게 자동화하나요?

globalize.now는 저장소를 지켜보다가 Git 푸시마다 수동 추출과 번역 채우기 단계를 대신 처리해요. Lovable 코드베이스에서 새로 하드코딩된 문자열을 찾아 Lingui가 기대하는 키와 PO 항목을 만들고, 번역을 생성한 뒤 업데이트된 카탈로그를 다시 커밋해요. 명령을 직접 실행하지 않아도 src/locales 폴더가 항상 최신 상태예요.

globalize.now에서 저장소를 한 번 연결하면 바로 감시를 시작해요. 에디터에서 설정하려면 Skill을 설치하세요.

npx skills add globalize-now/globalize-skills

Lovable 안에서는 워크스페이스에 lovable-i18n Skill을 추가한 뒤 Lovable에 i18n 설정을 요청하세요. 런타임은 그대로 Lingui이므로 앱이 렌더링되는 방식은 달라지지 않아요. 달라지는 건 로케일 파일을 신경 쓸 필요가 없어진다는 점이에요. 한 번 설정하면 푸시마다 동기화되는 이 모델은 vibe coder 워크플로와 개발자 설정의 바탕이기도 해요.

혼자 만드는 개발자에게 요금은 단순해요. Starter 요금제는 월 €20이고 €20 상당의 크레딧이 포함되며, 사용자 수나 언어 수에 따른 요금은 없어요. 새 워크스페이스에는 14일간 유효한 €5 체험 크레딧이 1회 제공되는데, 작은 앱 하나를 처음부터 끝까지 번역하기에 충분해요.


런타임 위젯을 대신 써도 될까요? Lovalingo가 남긴 교훈

번역이 특정 벤더보다 오래 살아남길 원한다면 권하지 않아요. 런타임 번역 위젯은 처음엔 편하지만, 앱이 다른 회사의 서버가 계속 켜져 있다는 전제에 의존하게 되고, 이 의존성에는 실제로 발생하는 장애 시나리오가 있어요.

Lovable 개발자들에게 인기 있던 런타임 위젯 Lovalingo는 2026년 8월 31일에 서비스를 종료하며, 신규 가입을 받지 않고 후속 서비스도 따로 지정하지 않았다고 발표했어요. 자체 마이그레이션 안내에서도 프로젝트가 직접 소유하는 국제화로 옮기라고 하는데, 바로 이 가이드의 커밋된 카탈로그 방식이에요. 위젯 벤더가 종료하면 주입되던 번역이 멈추고 UI는 영어로 돌아가요. 내 저장소에 있는 파일은 그렇지 않아요. 이미 위젯을 쓰고 있다면 Lovalingo 종료 마이그레이션 가이드에서 전환 과정을 안내해요. AI로 만든 앱에서 커밋된 카탈로그가 더 나은 이유는 푸시마다 번역이 깨지는 문제에서 확인할 수 있어요.

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

globalize.now 무료로 시작하기