Foundations

Internationalization

Groudit UI 는 다국어 + 양방향(LTR/RTL) 텍스트를 모두 지원합니다. 글로벌 대기업에서 요구되는 40개 언어 + RTL 지원 표준을 따릅니다.

설계 원칙

i18n 을 위한 4가지 기반.

컴포넌트 라이브러리 자체는 텍스트를 가지지 않습니다. 사용자가 자기 언어로 children 을 주입. 우리가 강요하는 번역 키 X.

ml-2 / mr-2 같은 directional 클래스 대신 ms-2 / me-2 (start/end) 사용. RTL 자동 반전.

사용자 언어가 RTL 이면 html dir="rtl" 자동 설정. Provider 가 처리.

날짜·숫자·통화는 Intl.DateTimeFormat / Intl.NumberFormat 활용. 사용자 로케일 자동 반영.

현재 사이트가 지원하는 언어. 컴포넌트 자체는 모든 언어 호환.

Code	Language	Direction	Status
ko	한국어	LTR	Active
en	English	LTR	Active
ja	日本語	LTR	Planned
zh	中文	LTR	Planned
ar	العربية	RTL	Planned
he	עברית	RTL	Planned

아랍어 / 히브리어 등 RTL 언어에서 모든 컴포넌트가 자연스럽게 좌우 반전됩니다. Tailwind 4 의 logical CSS properties (ms-/me-/text-start/text-end) 를 사용해 별도 RTL 빌드 없이 자동 대응.

모든 텍스트(label, placeholder, button children)는 사용자가 본인 i18n 시스템(next-intl, react-i18next, formatjs 등) 으로 주입합니다. Groudit UI 컴포넌트는 어떤 언어든 그대로 받아 렌더합니다.