Cursor에서 globalize.now 사용하기
명령어 하나로 Cursor로 만든 앱에서 문자열을 추출하고 로케일 파일을 생성해요.
Cursor는 동작하는 UI를 빠르게 만들지만, 보통 JSX에 영어를 그대로 하드코딩해요. globalize.now는 하드코딩된 문자열을 추출해 번역 키를 만들고 로케일 파일을 생성해서, Cursor로 만든 앱을 번역할 준비가 된 코드베이스로 바꿔요. 설정은 명령어 한 줄이면 되고, 이후에는 Git 푸시마다 동기화돼요.
사전 준비
- Cursor로 만든 프로젝트
- Git 저장소
- Node.js 18 이상
- 설치된 JavaScript i18n 라이브러리(i18next, next-intl 등). 처음부터 시작한다면 없어도 돼요
Cursor에 globalize.now 설정하기
Cursor 프로젝트를 열고 Git 확인하기
Cursor에서 저장소를 열고, 코드베이스가 커밋되어 Git 원격 저장소에 푸시돼 있는지 확인하세요. 그래야 이후 푸시가 동기화를 트리거할 수 있어요.
프로젝트 루트에서 Skills 설치 명령 실행하기
globalize.now에서 저장소를 연결해 앱 안에서 변환하거나, 저장소 루트의 터미널에서 Globalize 에이전트 Skill을 설치하세요. 그러면 어시스턴트가 i18n을 구성하고 전체 트리를 스캔해요.
npx skills add globalize-now/globalize-skills --all에이전트가 코드베이스를 분석하게 하기
에이전트 안내에 따라 컴포넌트와 라우트 전반에서 사용자에게 보이는 하드코딩된 문자열을 찾게 하세요.
제안된 번역 키 구조 검토하기
브랜치에 리팩터링이 반영되기 전에 제안된 키 구조와 이름을 확인하세요.
추출 결과와 로케일 파일 확인하기
변경 사항을 승인하면 키가 생성되고, 컴포넌트가 리터럴 대신 런타임 i18n API를 호출하며, 로케일 파일이 저장소에 기록돼요.
커밋하고 푸시하기
변경 사항을 커밋하고 기본 브랜치에 푸시하세요. 그러면 이후 Git 푸시에서도 globalize.now가 새 문자열을 계속 맞춰 줘요.
MCP로 연결하기(선택)
Cursor에서 Globalize를 직접 제어하고 싶으신가요? 코드가 i18n에 맞게 준비되면 MCP를 연결하세요.
~/.cursor/mcp.json에 추가하세요
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}더 알아보기: MCP 연결하기
자주 겪는 문제
Cursor가 하드코딩된 문자열을 계속 새로 추가해요
해결 방법: globalize.now는 Git에 푸시할 때마다 실행되므로, 새 리터럴이 릴리스 사이에 조용히 쌓이지 않고 자동으로 감지돼요.
번역 키가 기존 i18n 설정과 충돌해요
해결 방법: globalize.now는 기존 i18n 라이브러리를 감지해 그 규칙을 따르므로, 새 키가 현재 카탈로그와 충돌하지 않고 자연스럽게 확장돼요.
자주 묻는 질문
Cursor로 만든 프로젝트라면 globalize.now를 모두 쓸 수 있나요?
네, globalize.now가 에이전트 Skill로 지원하는 스택(Next.js, React, Vue 같은 최신 JavaScript 프레임워크)이라면 가능해요. globalize.now는 어떤 에디터가 JSX를 만들었는지가 아니라, 하드코딩된 UI 문자열을 추출해 키와 로케일 파일을 만드는 데 집중해요. 프로젝트 루트에서 npx skills add globalize-now/globalize-skills를 실행하고 안내에 따라 진행하면, 에이전트가 저장소를 스캔해 머지할 수 있는 diff를 열어 줘요.
Cursor 전용 패턴을 감지하도록 globalize.now를 따로 설정해야 하나요?
Cursor용 통합을 따로 설정할 필요가 없어요. 파일을 직접 작성했든 Cursor가 작성했든 globalize.now는 저장소를 똑같이 분석해요. Skill이 사용자에게 보이는 리터럴과 라우팅 구조를 찾고, 도입한 i18n 라이브러리에 맞는 키를 제안해요. 변경 계획은 다른 변경 사항과 마찬가지로 Git에서 리뷰하세요.
이미 i18n이 일부 적용된 Cursor 프로젝트에도 globalize.now를 쓸 수 있나요?
네. 키와 로케일 파일이 이미 있으면 기존 카탈로그를 확장하도록 설계되어 있어요. globalize.now는 사용 중인 런타임 라이브러리를 감지하고, 기존 작업을 버리지 않은 채 추가분만 제안해요. 남은 리터럴은 점진적으로 마이그레이션하면 돼요. 새 UI도 계속 반영되도록 Git 푸시는 그대로 유지하세요.
Cursor 프로젝트에서 globalize.now 결과물은 어떤 i18n 라이브러리와 함께 쓸 수 있나요?
globalize.now는 특정 라이브러리에 묶이지 않아요. i18next, next-intl, react-intl, Lingui, vue-i18n 같은 주요 런타임과 함께 쓸 수 있는 구조화된 키와 로케일 파일을 만들어요. Cursor 프로젝트는 선택한 스택을 그대로 유지하고, globalize.now가 추출과 동기화를 맡아요. 프레임워크가 요구하는 프로바이더나 미들웨어 연결은 에이전트 Skill이 도와줘요.
globalize.now가 Cursor로 생성한 컴포넌트를 수정하나요?
globalize.now는 동작은 그대로 두고, 리터럴이 i18n API(예: t() 또는 메시지 컴포넌트)를 거치도록 호출부를 바꿔요. 머지하기 전에 Git에서 diff를 리뷰하세요. Cursor가 만든 변경과 똑같아요. 첫 머지 이후에는 별도 내보내기 단계 없이, 푸시할 때마다 새 문자열이 자동으로 동기화돼요.
Cursor에서 globalize.now를 어디서 실행하나요?
Cursor의 통합 터미널(또는 저장소 루트를 가리키는 아무 셸)에서 저장소 루트 기준으로 npx skills add globalize-now/globalize-skills를 실행하세요. Skill은 현재 프로젝트 범위에서 동작해요. 현지화 Skill 번들을 설치한 뒤, 이어지는 프롬프트는 에이전트에게 넘겨요. 루트에서 실행해야 CLI가 트리를 스캔하는 방식과 경로 감지가 맞아떨어져요.
Cursor에서 globalize.now 사용해 보기
프로젝트 루트에서 시작하세요:
npx skills add globalize-now/globalize-skills --all