아랍어 빌드는 깨져 보이지만 번역은 멀쩡해요. 사이드바는 왼쪽에 있고, 뒤로 가기 화살표는 왼쪽을 가리키고, 아바타는 모든 카드의 왼쪽 가장자리에 붙어 있어요. 단어는 전부 아랍어인데 박스는 전부 영어 버전이 두고 간 자리 그대로예요. 텍스트 방향은 HTML 속성과 컴포넌트에 있는 CSS 결정의 조합이라서, 어떤 카탈로그 파일에도 담기지 않아요. globalize.now는 Git 푸시마다 문자열을 추출하고 카탈로그를 동기화하는 AI 기반 현지화 인프라예요.

Lovable 앱이 아랍어인데도 왼쪽에서 오른쪽으로 읽히는 이유가 뭘까요?

방향은 메시지가 아니라 문서와 스타일시트의 속성이기 때문이에요.

카탈로그는 원문 문자열과 번역 문자열의 쌍이에요. ar용으로 컴파일되고 컴포넌트가 그것을 렌더링하면 단어만 바뀌고 나머지는 그대로예요. 카탈로그가 globalize.now가 기록하는 Lingui든 react-i18next든 마찬가지예요. 어느 포맷에도 “사이드바는 반대편으로 가세요”라고 적을 자리는 없어요.

바꿔야 할 것은 두 가지예요. html 요소의 dir 속성은 인라인 축이 어느 쪽으로 흐르는지 브라우저에 알려 줘요. CSS는 물리적인 방향 이름 대신 그 축의 시작과 끝을 가리키도록 바꿔야 해요. 나머지는 이 두 가지에서 따라와요.

Lovable 앱에 아랍어를 추가하면 실제로 무엇이 깨지나요?

문제는 예측 가능한 곳에 몰려 있고, 전부 문구가 아니라 스타일링 문제예요.

  • 내비게이션 드로어와 사이드바가 물리적 왼쪽에 그대로 남아요.
  • 쉐브론, 뒤로 가기 화살표, 진행 표시기가 엉뚱한 방향을 가리켜요.
  • 비대칭 패딩 때문에 콘텐츠가 엉뚱한 가장자리에 붙고, 레이블이 한쪽으로 몰려요.
  • 제목에 text-left가 있으면 아랍어가 컨테이너 왼쪽에 고정돼요.
  • absolute로 배치한 배지와 닫기 버튼이 읽는 사람이 기대하는 곳과 반대쪽 모서리에 놓여요.
  • 활성 목록 항목을 표시하는 왼쪽 테두리가 시작 가장자리가 아니라 끝 가장자리에 나타나요.
  • 아랍어 문장 속 영문 제품 코드는 방향 힌트가 없으면 순서가 예측할 수 없게 뒤섞여요.

번역 결함은 하나도 없어요. 전부 클래스 이름에 박혀 있는 물리적 방향 때문이에요.

로케일 태그에서 텍스트 방향을 도출하려면 어떻게 하나요?

로케일에 어느 방향을 쓰는지 물어보고, 그 답을 문서에 기록하세요.

Intl.Locale.prototype.getTextInfo()는 로케일 태그에 대해 ltr 또는 rtl 방향을 반환해요. 2026년 7월에 Baseline newly available 상태가 되었는데, 이는 모든 주요 브라우저의 최신 버전에는 들어갔지만 실제 사용자 대부분이 쓰는 브라우저에는 아직 없다는 뜻이에요. 아래 폴백을 실제로 쓰는 경로로 보고, API는 언젠가 그 폴백을 은퇴시킬 존재로 여기세요.

// getTextInfo() is not yet in TypeScript's bundled Intl.Locale definitions.
declare global {
  namespace Intl {
    interface Locale {
      getTextInfo?(): { direction: "ltr" | "rtl" };
    }
  }
}

// Stopgap for runtimes without getTextInfo(). This set is the one place where
// adding a new right-to-left language still costs you a code change.
const RTL_FALLBACK = new Set([
  "ar", "he", "fa", "ur", "ps", "sd", "yi", "dv", "ckb", "ug", "nqo", "syr",
]);

export function directionFor(locale: string): "ltr" | "rtl" {
  let tag: Intl.Locale | undefined;
  try {
    tag = new Intl.Locale(locale);
  } catch {
    // Malformed tag. Fall through to the string path below.
  }

  const direction = tag?.getTextInfo?.().direction;
  if (direction === "ltr" || direction === "rtl") return direction;

  const language = tag?.language ?? locale.split(/[-_]/)[0].toLowerCase();
  return RTL_FALLBACK.has(language) ? "rtl" : "ltr";
}

try 지점은 두 군데가 중요해요. new Intl.Locale()는 잘못된 태그에서 RangeError를 던지고, getTextInfo()는 오래된 런타임에는 아예 없어요. 두 번째만 처리하는 게 흔한 버그예요. 쿼리 스트링으로 ar_EG 같은 로케일이 들어오면 함수가 자체 복구 경로로 들어갔다가 잡히지 않은 에러로 그대로 튀어나와요.

앱이 이미 활성 로케일을 아는 곳이라면 어디서든 두 속성을 모두 설정하세요. Lovable은 현재 Vite 싱글 페이지 앱과 서버 렌더링 TanStack Start 앱, 두 가지 형태로 스캐폴딩하니 프로젝트가 실제로 무엇을 생성했는지 확인하세요. TanStack Start에서는 루트 문서 컴포넌트이고, Vite에서는 i18n 프로바이더를 마운트하는 곳이에요.

<html lang={locale} dir={directionFor(locale)}>

dir는 래퍼 div가 아니라 html에 두세요. 포털, 모달, 토스트는 컴포넌트 트리 밖에서 렌더링되지만 여전히 방향을 상속받아야 해요.

오른쪽에서 왼쪽 레이아웃을 위해 바꿔야 할 Tailwind 클래스는 무엇인가요?

물리적인 방향을 이름에 담은 클래스예요. 논리적 대응 클래스는 인라인 축을 따르기 때문에 dir가 바뀌면 알아서 뒤집혀요.

물리적 유틸리티논리적 대체설정하는 속성
ml-4 / mr-4ms-4 / me-4margin-inline-start / margin-inline-end
pl-6 / pr-6ps-6 / pe-6padding-inline-start / padding-inline-end
left-0 / right-0start-0 / end-0inset-inline-start / inset-inline-end
text-left / text-righttext-start / text-end인라인 축 기준 텍스트 정렬
border-l / border-rborder-s / border-e시작 / 끝 테두리
rounded-l-lg / rounded-r-lgrounded-s-lg / rounded-e-lg시작 / 끝 모서리
float-left / float-rightfloat-start / float-end인라인 축 기준 float
clear-left / clear-rightclear-start / clear-end인라인 축 기준 clear
scroll-ml-4 / scroll-mr-4scroll-ms-4 / scroll-me-4scroll-snap 마진

Tailwind의 margin 문서에서 효과를 바로 확인할 수 있어요. dir="ltr"와 dir="rtl" 컨테이너 안에 렌더링한 ms-8과 me-8은 서로 반대편에 놓여요. 논리적 속성 유틸리티는 Tailwind v3.3에서 추가되었으니, 오래된 프로젝트에는 없을 수 있어요.

이름만 바꿀 게 아니라 한 번 더 살펴봐야 하는 유틸리티가 둘 있어요. space-x-*와 divide-x-*는 형제 요소 사이에 간격과 테두리를 넣는데, 뒤집힌 행에서는 각 자식의 엉뚱한 쪽에 붙어요. Tailwind는 바로 이 경우를 위해 space-x-reverse와 divide-x-reverse를 제공해요. mt-*나 pb-* 같은 세로 유틸리티는 방향이 인라인 축에만 영향을 주므로 손댈 필요가 없어요.

논리적 속성으로 고칠 수 없는 것은 무엇인가요?

박스 모델 밖에서 방향을 인코딩하는 모든 것이에요. 여기서 rtl:와 ltr: 변형이 제 역할을 해요.

<ChevronRight className="rtl:rotate-180" />
<div className="bg-[url(/hero.svg)] bg-left rtl:bg-right" />
<div className="shadow-[4px_0_8px_rgba(0,0,0,.15)] rtl:shadow-[-4px_0_8px_rgba(0,0,0,.15)]" />

transform, 배경 위치, 그림자 오프셋, 그라디언트 각도, 캐러셀 스크롤 계산, “앞으로”를 뜻하는 모든 아이콘이 여기에 해당해요. 목록은 짧게 유지하세요. 요소 두 개 건너 하나꼴로 rtl:을 쓰고 있다면 기반 스타일이 여전히 물리적이라는 뜻이니, 그쪽을 논리적 스타일로 바꾸는 게 맞아요.

사용자 생성 콘텐츠는 별도로 처리해야 하고, 두 경우가 서로 달라요. 언어를 통제할 수 없는 블록 전체에는 dir="auto"를 쓰면 브라우저가 첫 번째 강한 방향 문자를 기준으로 블록의 기본 방향을 정해요.

<p dir="auto">{review.body}</p>

이미 방향이 정해진 문장 안의 외국 문자 구간, 즉 아랍어 본문 속 영문 SKU에는 dir="auto"가 아무 효과가 없어요. 이 속성은 인라인 구간을 격리하는 게 아니라 단락의 기본 방향을 정하기 때문이에요. 대신 그 구간을 감싸세요.

<bdi>{product.sku}</bdi>

번역 위젯이 레이아웃을 대신 뒤집어 주지 못하는 이유가 뭘까요?

위젯은 렌더링된 페이지의 텍스트 노드에 작동하는데, 방향 문제는 그 페이지를 만들어 낸 스타일에 있기 때문이에요.

런타임 서비스는 문서에 dir="rtl" 속성을 주입하고, 영어 화면이 그려진 뒤에 보이는 문자열을 번역할 수 있어요. 하지만 컴포넌트를 열어 ml-4 클래스를 ms-4 클래스로 바꿀 수는 없어요. ml-4 클래스는 서비스가 관리하지 않는 스타일시트 안에서 이미 margin-left 규칙으로 컴파일됐기 때문이에요. 결국 왼쪽에서 오른쪽으로 흐르는 레이아웃 안에 아랍어 텍스트가 들어간 화면이 나와요.

비용이 하나 더 있어요. 일부 Lovable 앱에서 쓰는 런타임 번역 서비스 Lovalingo는 2026년 8월 31일 23:59(CEST)에 서비스를 종료한다고 발표했어요. 마이그레이션 안내에서는 프로젝트가 직접 소유하는 국제화 방식으로 옮기고, 제거하기 전에 로케일 라우트, canonical URL, hreflang을 다시 검증하라고 해요. 벤더 제품 안에서 한 레이아웃 작업은 벤더와 함께 사라져요. 내 저장소에 있는 논리 유틸리티와 dir 속성은 그렇지 않아요. Lovalingo 비교에서도 문자열 계층에 대해 같은 이야기를 해요.

다음 Lovable 프롬프트가 이 작업을 되돌리지 않게 하려면 어떻게 해야 할까요?

한 번 변환한 뒤, 물리 유틸리티가 리뷰에서 눈에 띄게 만드세요.

  1. 워크플로를 설치하세요. Lovable 워크스페이스에서 lovable-i18n Skill을 추가하고 Lovable에 i18n 설정을 요청하면 돼요. 에디터 밖에서는 npx skills add globalize-now/globalize-skills로 설치하고, 모든 에이전트에 설치하려면 --all를 사용하세요.
  2. 위에서 소개한 directionFor로 로케일에 따라 html 요소의 방향을 지정하세요.
  3. 페이지를 감싸는 컴포넌트부터 시작해 모든 컴포넌트의 물리 유틸리티를 논리 유틸리티로 바꾸세요.
  4. rtl: 변형은 transform, 배경, 그림자, 방향성 아이콘에만 추가하고, 인라인으로 들어가는 외국 문자 구간에는 <bdi>을(를) 사용하세요.
  5. 리뷰 단계에 grep 게이트를 추가해서, 새로 생성된 물리 유틸리티가 머지되기 전에 실패하게 하세요.
rg -n '\b(ml|mr|pl|pr|scroll-m[lr])-|\b(float|clear|text)-(left|right)\b|\bborder-[lr]\b|\brounded-[lr]-|\b(left|right)-[0-9]' src/

5단계가 가장 중요해요. Lovable은 프롬프트마다 컴포넌트를 다시 생성하고, 설정 패널을 추가해 달라는 요청을 받은 모델은 ml-4 같은 클래스부터 쓰기 쉬워요. 이 모델들이 학습한 React 코드에는 물리 유틸리티가 압도적으로 많거든요. PR을 실패시키는 검사로 막는 편이, 3주 뒤 아랍어 스크린샷에서 문제를 발견하는 것보다 훨씬 부담이 적어요.

문자열 쪽 루프는 알아서 돌아가요. globalize.now가 Lovable이 생성한 코드에서 새 하드코딩된 문자열을 추출해 카탈로그에 쓰고, Git 푸시마다 동기화해요. 계속 프롬프트를 입력하는 동안에도 아랍어 빌드가 최신 상태로 유지돼요. Vite 가이드와 TanStack Start 가이드에서 설명한 것과 같은 방식이고, 푸시할 때마다 번역이 깨지지 않는 이유이기도 해요.

아랍어를 추가해도 요금제에는 추가 비용이 없어요. Starter 요금제는 조직당 월 €20이고, €20 상당의 번역 크레딧이 포함돼요. 이후 사용량은 계속 크레딧 잔액에서 차감되고, 사용자 수나 언어 수에 따른 요금은 없으며 RTL 언어도 포함돼요. 설정 방법은 Lovable 연동 페이지에서, 엔지니어링 상세는 개발자 페이지에서, 비개발자 빌더를 위한 더 짧은 가이드는 vibe coder 페이지에서 볼 수 있어요.

레이아웃은 한 번만 바꾸면 계속 유지돼요

방향은 저장소가 한 번만 정하면 되는 결정이에요. 프롬프트를 입력할 때마다 바뀌는 건 문자열이고, 그 부분은 알아서 돌아가요.

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

globalize.now 무료로 시작하기