언어마다 고유한 URL을 부여하고, 그 URL에 상호 참조하는 hreflang 태그를 달아요. React 상태로 문자열을 바꿔 끼우는 드롭다운은 이미 사이트에 들어온 사람에게는 인터페이스를 번역해 주지만, 검색 엔진이 색인할 대상은 만들어 주지 않아서 독일어와 스페인어 버전은 계속 보이지 않아요. globalize.now는 AI 기반 현지화 인프라로, 하드코딩된 문자열을 커밋 가능한 Lingui PO 카탈로그로 추출하고 Git 푸시마다 동기화해요. 그래서 로케일별 라우트를 일회성 작업이 아니라 꾸준히 유지할 수 있어요.
대부분의 Lovable 빌더가 건너뛰는 단계가 바로 이거예요. 앱은 번역됐고 브라우저에서 전환 버튼도 잘 동작하는데, 트래픽은 들어오지 않아요.
Google이 Lovable 앱의 다른 언어를 색인하지 않는 이유는 뭔가요?
그 언어들에 주소가 없을 가능성이 거의 확실하기 때문이에요.
AI 빌더가 기본으로 만드는 패턴은 useState 로케일 값과 그 값을 바꾸는 드롭다운이에요. 모든 언어가 같은 URL에서 렌더링되죠. 그 URL을 요청한 크롤러는 한 언어로 된 응답 하나를 받고 페이지 하나만 색인해요. 발견할 대상도 없고, 다른 언어 버전이 있다고 알려 주는 신호도 없어요.
해결책은 겉모양이 아니라 구조에 있어요. Google의 현지화 버전 가이드는 대체 언어 페이지가 URL로 식별되고, 이들을 잇는 어노테이션을 세트의 모든 페이지가 서로 반환해야 한다고 분명히 밝혀요. 가져올 수 있는 주소로 /de/pricing 페이지가 존재하지 않으면 마크업을 아무리 추가해도 검색에 나타나지 않아요.
제대로 된 언어 전환 버튼은 무엇을 해야 하나요?
순서대로 세 가지예요. URL을 바꾸고, 사용자를 같은 페이지에 머물게 하고, 선택을 기억하는 거예요.
검색에서 중요한 건 URL을 바꾸는 부분이에요. 같은 페이지에 머물게 하는 부분은 사용자에게 중요한데, 대부분의 구현이 여기서 실패해요. /en/pricing에서 전환하면 도착해야 할 곳은 /de/pricing이고, /de/는 아니에요. 선택을 기억하는 건 편의 기능이고, URL에 명시된 로케일을 덮어쓰면 안 돼요.
짚고 넘어갈 안티패턴이 하나 있어요. 브라우저 언어에 따른 자동 리디렉션이에요. 미국의 크롤러가 요청한 주소 /de/pricing가 /en/pricing로 튕겨 나가면 독일어 페이지는 사실상 존재하지 않는 거예요. 전환은 제안만 하고 강제하지 마세요.
Lovable TanStack Start 앱에 로케일 라우팅은 어떻게 추가하나요?
라우트 트리 최상단에 로케일 세그먼트를 추가하고, 거기서 카탈로그를 활성화해요.
Lovable은 2026년 5월부터 새 프로젝트를 TanStack Start 기반 서버 사이드 렌더링으로 전환했어요. 그래서 로케일 접두사가 붙은 라우트는 첫 응답에서 완전히 번역된 HTML을 반환해요. 크롤러가 받아야 할 바로 그 결과예요.
나머지 라우트를 감싸는 동적 세그먼트를 만들어요.
src/routes/
$locale/
route.tsx
index.tsx
pricing.tsx
그다음 하위 컴포넌트가 렌더링되기 전에 해당 로케일의 Lingui 카탈로그를 활성화해요.
// src/routes/$locale/route.tsx
import { createFileRoute, Outlet, notFound } from "@tanstack/react-router";
import { i18n } from "@lingui/core";
import { I18nProvider } from "@lingui/react";
const LOCALES = ["en", "de", "es", "fr"] as const;
export const Route = createFileRoute("/$locale")({
loader: async ({ params }) => {
if (!LOCALES.includes(params.locale as (typeof LOCALES)[number])) {
throw notFound();
}
const { messages } = await import(
`../../locales/${params.locale}/messages.po`
);
i18n.loadAndActivate({ locale: params.locale, messages });
return { locale: params.locale };
},
component: LocaleLayout,
});
function LocaleLayout() {
return (
<I18nProvider i18n={i18n}>
<Outlet />
</I18nProvider>
);
}
여기서 실제로 중요한 디테일이 두 가지 있어요. 알 수 없는 로케일을 거부하는 notFound() 덕분에, 크롤러가 시도하는 엉뚱한 경로마다 /xx/pricing 쪽에서 soft 200을 반환하는 일을 막을 수 있어요. 그리고 라우트 로더에서 카탈로그를 불러오면 HTML이 직렬화되기 전, 서버에서 활성화가 끝나요.
기존 스택을 쓴다면 URL 구조는 같지만 렌더링 경로가 달라요. Lovable Vite i18n 가이드에서 이 경우를 다루고, TanStack Start 설정 가이드에서 SSR 쪽을 더 자세히 다뤄요.
언어 전환 버튼 컴포넌트는 어떻게 만드나요?
로케일 파라미터만 바꿔 같은 라우트로 이동하고, 모든 옵션을 실제 링크로 렌더링해요.
// src/components/LanguageSwitcher.tsx
import { Link, useLocation, useParams } from "@tanstack/react-router";
const LOCALES = {
en: "English",
de: "Deutsch",
es: "Español",
fr: "Français",
} as const;
export function LanguageSwitcher() {
const { locale } = useParams({ from: "/$locale" });
const { pathname } = useLocation();
const rest = pathname.replace(`/${locale}`, "") || "/";
return (
<nav aria-label="Language">
<ul>
{Object.entries(LOCALES).map(([code, label]) => (
<li key={code}>
<Link
to={`/${code}${rest}`}
hrefLang={code}
aria-current={code === locale ? "true" : undefined}
>
{label}
</Link>
</li>
))}
</ul>
</nav>
);
}
옵션은 라우터 호출에 연결한 버튼이 아니라 앵커로 렌더링해요. 앵커는 크롤링이 가능해서 사이트맵 외에 검색 엔진이 로케일 라우트를 찾는 두 번째 경로가 돼요. 각 옵션은 국기 대신 해당 언어 자체의 이름으로 표기해요. 국기는 국가를 뜻하는데 스페인어는 국가가 아니니까요.
hreflang 태그는 어떻게 올바르게 출력하나요?
세트의 모든 페이지에 로케일마다 어노테이션을 하나씩 출력해요. 자기 참조와 x-default도 포함해요.
Google은 대체 URL이 서로 되돌아 링크하는지 검증하고, 상호 참조하지 않거나 페이지 자체의 canonical과 다른 곳을 가리키는 어노테이션은 무시해요. 그래서 프로그래밍으로 생성하는 것이 유일하게 현실적인 방법이에요. 20페이지에 4개 언어면 일관되게 관리해야 할 어노테이션이 320개나 되니까요.
TanStack Start에서는 라우트의 head에서 만들어요.
// src/routes/$locale/route.tsx (excerpt)
const SITE = "https://example.com";
const LOCALES = ["en", "de", "es", "fr"] as const;
export const Route = createFileRoute("/$locale")({
head: ({ params, location }) => {
const rest = location.pathname.replace(`/${params.locale}`, "") || "/";
return {
links: [
{ rel: "canonical", href: `${SITE}/${params.locale}${rest}` },
...LOCALES.map((code) => ({
rel: "alternate",
hrefLang: code,
href: `${SITE}/${code}${rest}`,
})),
{ rel: "alternate", hrefLang: "x-default", href: `${SITE}/en${rest}` },
],
};
},
});
어노테이션이 라우터가 쓰는 LOCALES 배열에서 그대로 만들어지므로, 언어를 추가하면 라우트, 전환 버튼, hreflang 세트가 한 번에 갱신돼요. 지켜야 할 핵심은 바로 이 구조예요. 목록은 하나, 사용처는 셋.
같은 URL을 xhtml:link alternate와 함께 사이트맵에도 추가하고, <html lang> 속성이 현재 로케일과 일치하는지 확인해요. lang 속성은 hreflang에 영향을 주지 않지만 스크린 리더와 브라우저 번역 안내에는 영향을 줘요.
런타임 번역 위젯으로는 왜 안 되나요?
위젯은 페이지가 이미 영어로 제공된 뒤에 번역하기 때문이에요.
런타임 위젯은 스크립트가 로드된 뒤 브라우저에서 텍스트를 바꿔 끼워요. 크롤러가 처음 받는 응답은 영어 DOM이고, 번역본은 클라이언트 JavaScript가 실행된 뒤에야 생겨요. 일부 위젯은 hreflang을 생성해 주는 서브도메인이나 서브디렉터리 모드를 제공하지만, 그러면 URL 구조와 어노테이션이 내 저장소가 아니라 벤더의 인프라에 속하게 돼요.
이 의존성의 대가는 더 이상 가정이 아니에요. Lovable 빌더 사이에서 인기 있던 번역 위젯 Lovalingo는 2026년 8월 31일에 종료되고, 자체 안내에서도 사용자에게 프로젝트가 직접 소유하는 국제화로 옮기라고 해요. 위젯이 사라지면 위젯이 만든 언어별 URL도 함께 사라지고 사이트는 영어로 되돌아가요. 커밋된 카탈로그와 내 코드에 정의한 라우트에는 그런 스위치가 없어요. 이 마이그레이션의 실전 버전은 Lovalingo 대안 비교에 정리해 뒀어요.
기존 Vite SPA 스택은 어떤가요?
URL 구조는 같고, 렌더링이 달라요.
TanStack Start로 전환하기 전에 만든 Lovable 프로젝트는 Vite와 React 기반 싱글 페이지 앱으로, 정적 파일로 제공되고 브라우저에서 렌더링돼요. 이 경우에도 /:locale 기반 라우팅, hreflang 출력, 저장소 안 카탈로그 관리는 모두 할 수 있어요. 잃는 건 크롤러가 받는 첫 바이트에 번역된 콘텐츠가 들어 있다는 보장이에요.
SEO가 현지화의 이유라면 로케일 라우트에 프리렌더링을 추가해 각 라우트가 실제 HTML을 내려주게 하거나, 서버 렌더링 스택으로 옮기는 걸 계획하세요. 클라이언트 렌더링 앱 위에 런타임 위젯을 얹는 방식으로 풀지는 마세요. 클라이언트 렌더링이 두 번 겹쳐서 모든 언어에서 첫 의미 있는 화면이 오히려 느려져요.
로케일 4개가 서로 어긋나지 않게 하려면 어떻게 해야 하나요?
추출을 자동화하고, 카탈로그를 소스 코드처럼 다루세요.
로케일별 라우팅이 방치되는 이유는 라우팅 자체가 아니에요. 새 기능을 추가할 때마다 아무도 추출하지 않은 영어 문자열이 생겨서, /de/에 영어 조각이 서서히 쌓이고 독일어를 아예 지원하지 않는 것보다 오히려 더 나빠 보이기 시작하기 때문이에요. globalize.now가 바로 이 부분을 맡아요. Lovable 워크스페이스에 lovable-i18n Skill을 추가하고 Lovable에 i18n 설정을 요청하거나, 로컬에 Skill을 설치하세요.
npx skills add globalize-now/globalize-skills
모든 에이전트에 설치하려면 --all을 추가하세요. 새 문자열은 추출되고, 키가 생성되고, 카탈로그가 번역되며, 갱신된 PO 파일이 Git 푸시마다 커밋돼요.
요금은 조직당 월 €20이고, 매달 €20 상당의 번역 크레딧이 포함돼요. 그 이상은 제공업체 원가에 마크업을 더해 크레딧 잔액에서 차감돼요. 사용자 수나 언어 수에 따른 요금이 없어서, 다섯 번째 로케일을 추가해도 바뀌는 건 라우팅 설정이지 청구액이 아니에요. 가입하면 카드 없이 1회성 €5 체험 크레딧(14일간 유효)을 받아요. 개발자와 AI로 만든 앱을 출시하는 사람들을 위한 자세한 내용도 확인해 보세요.
라우팅과 hreflang은 오후 한나절이면 끝나는 작업이에요. 앱이 바뀌는 동안 카탈로그 4개를 완전하게 유지하는 일은 끝이 없고, globalize.now가 바로 그 부분을 자동화해요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기