sh-ui-cli 0.90.0 → 0.92.0

package/data/changelog/versions.json

@@ -2,6 +2,33 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.92.0",
+      "date": "2026-05-14",
+      "title": "vite 프리셋 react-i18next i18n opt-in (--i18n + --locales)",
+      "type": "minor",
+      "highlights": [
+        "**`--i18n react-i18next` 옵션** — vite preset 에 opt-in i18n 셋업 추가. `sh-ui-cli create --platform vite --i18n react-i18next --locales ko,en` 한 줄로 i18next + react-i18next + browser-languagedetector + http-backend 셋업 + `I18nProvider` + locale JSON 자동 emit. 디폴트 `'none'` 이라 기존 사용자 영향 X. ai-org 처럼 i18n 부터 들어가는 워크로드의 30 초 boilerplate 제거.",
+        "**Arch-aware 파일 위치** — fsd 일 때 `src/shared/i18n/` + `src/app/providers/I18nProvider.tsx`, flat 일 때 `src/lib/i18n/` + `src/components/providers/I18nProvider.tsx`. `emitI18n` 헬퍼가 arch descriptor 의 `paths`/`aliases` 기반 경로 자동 결정. 사용자가 `import i18n from '@/shared/i18n'` 또는 `'@/lib/i18n'` 즉시 가능.",
+        "**Monorepo + Tauri + i18n 조합 모두 동작** — `--structure monorepo --tauri --i18n react-i18next` 한 번에 OK. `apps/{appName}/` 안에 `src-tauri/` 와 `src/shared/i18n/` 가 같이 emit, 각 의존성이 app 의 `package.json` 에 정확히. `sh-ui-cli add-app` 도 `--i18n` 받음.",
+        "**Locale 시드 정책** — 첫 locale (fallbackLng) 만 `{ greeting: 'Hello World', app_title: 'sh-ui app' }` 시드, 나머지는 `{}` 빈 객체로 시작. 사용자가 키 채우는 흐름 자연스럽게. backend (`i18next-http-backend`) 가 `/locales/{lng}/{ns}.json` lazy-load 하므로 dev 부터 namespace 분리 + lazy 동작.",
+        "**가드 + 회귀** — `i18n + platform !== 'vite'` 조합은 CLI + MCP 양쪽에서 명시적 Korean 에러. Smoke V15 (fsd + ko,en happy path), V16 (i18n=none 디폴트 회귀 가드 — 어떤 i18n 파일도 안 들어감), V17 (flat + ko,en,ja — 3개 locale 중 첫 locale 만 시드, ja 는 빈 객체). docs `/create` 페이지도 i18n 토글 + locales 인풋 노출."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.92.0"
+    },
+    {
+      "version": "0.91.0",
+      "date": "2026-05-14",
+      "title": "add-app 가 platform (next/vite) + tauri 인식 — vite monorepo 에 새 앱 정상 추가",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui-cli add-app` + MCP `sh_ui_add_app` 가 `platform: vite | next` 인식** — 이전엔 Next.js 하드코딩이라 vite monorepo (v0.87.0+) 에 `add-app` 하면 잘못된 Next.js 앱이 들어가던 빈틈 해소. `--platform` 미지정 시 기존 `apps/*` 의 `package.json` deps 스캔해서 platform 추론 (모든 앱이 같은 플랫폼이면 그 값으로). 혼재 or 빈 apps/ 면 TTY 면 prompt, 비대화형이면 'next' fallback.",
+        "**`--tauri` 옵션이 add-app 에도 동작** — `sh-ui-cli add-app admin --tauri` 또는 MCP `tauri: true` 로 `apps/{name}/src-tauri/` 까지 한 번에 emit. v0.90.0 의 monorepo+tauri 와 동일하게 dev port 가 `tauri.conf.json` 의 `devUrl` 과 `vite.config.ts` 의 `server.port` 양쪽에 자동 박힘. tauri + platform=next 조합은 CLI + MCP 양쪽에서 명시적 Korean 에러.",
+        "**Smoke V13 + V14 회귀 가드** — V13 은 vite monorepo create 후 `add-app admin --port 3001 --tauri` (platform 미지정) 가 추론으로 vite 선택 + apps/admin/src-tauri/ + devUrl=3001 + crate name 까지 단언. V14 는 next monorepo 에 `add-app --platform next --tauri` 가 에러 throw 확인. 기존 scenarios 4 + 4b 도 새 platform 추론 분기에 맞춰 prompt 모의 갱신.",
+        "**Backward-compat 확인** — Next.js 모노레포에서 기존 `add-app` 호출 흐름은 platform 추론 결과 'next' 가 나와 동일 동작. 깨지는 호출 없음."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.91.0"
+    },
     {
       "version": "0.90.0",
       "date": "2026-05-14",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.90.0",
+  "version": "0.92.0",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/api.d.ts

@@ -141,6 +141,10 @@ export interface DescribeTemplateOptions {
   appName?: string;
   /** platform=vite + structure=standalone 일 때 Tauri 2.x 셸(`src-tauri/`) 동시 emit. */
   tauri?: boolean;
+  /** vite 전용 — react-i18next opt-in. v0.92.0+ */
+  i18n?: 'none' | 'react-i18next';
+  /** i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en' */
+  locales?: string;
 }
 
 export interface DescribeTemplateGroup {

package/src/constants.js

@@ -54,3 +54,9 @@ export const INIT_DEFAULTS = {
   mode: 'light-dark',
   cssFramework: CSS_FRAMEWORK_DEFAULT,
 };
+
+// ─── i18n (vite preset 전용 — v0.92.0+) ───
+// 'none' 디폴트 — opt-in 으로 react-i18next 설치 + 셋업. 향후 lingui / react-intl 등 추가 시 enum 확장.
+export const I18N_LIBRARIES = ['none', 'react-i18next'];
+export const I18N_DEFAULT = 'none';
+export const I18N_DEFAULT_LOCALES = 'ko,en';

package/src/create/cli-args.js

@@ -3,6 +3,7 @@ import {
   CREATE_STRUCTURES,
   CSS_FRAMEWORKS_SUPPORTED,
   CSS_FRAMEWORKS_PLANNED,
+  I18N_LIBRARIES,
 } from '../constants.js';
 import { allPlugins } from './plugins/index.js';
 import { allArchitectures } from './architectures/index.js';
@@ -12,7 +13,7 @@ const VALID_STRUCTURES = CREATE_STRUCTURES;
 const VALID_PLUGINS = allPlugins.map((p) => p.name);
 const VALID_ARCHES = allArchitectures.map((a) => a.name);
 
-const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port'];
+const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales'];
 const BOOL_FLAGS = ['yes', 'help', 'dry-run', 'tauri'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
@@ -75,6 +76,9 @@ export const parseArgs = (argv) => {
         `--arch 는 ${VALID_ARCHES.join('/')} 중 하나여야 함 (받은 값: ${value})`,
       );
     }
+    if (name === 'i18n' && !I18N_LIBRARIES.includes(value)) {
+      throw new Error(`--i18n 은 ${I18N_LIBRARIES.join('/')} 중 하나여야 함 (받은 값: ${value})`);
+    }
     if (name === 'css' && !CSS_FRAMEWORKS_SUPPORTED.includes(value)) {
       // planned 값은 '곧 옵니다' 신호로 분기 — 사용자 의도가 더 명확히 전달.
       if (CSS_FRAMEWORKS_PLANNED.includes(value)) {

package/src/create/describeTemplate.js

@@ -36,6 +36,8 @@ import { CSS_FRAMEWORK_DEFAULT } from '../constants.js';
  * @property {string} [projectName]
  * @property {string} [appName]                       monorepo 첫 앱 이름. 기본 'web'
  * @property {boolean} [tauri]                        platform=vite (standalone/monorepo 둘 다) 일 때 Tauri 2.x 셸 같이 emit
+ * @property {'none'|'react-i18next'} [i18n]          vite 전용 — react-i18next 셋업
+ * @property {string} [locales]                       i18n 활성화 시 생성할 locale 코드 (comma-separated, default 'ko,en')
  */
 
 /**
@@ -64,6 +66,8 @@ export function describeTemplate(opts = {}) {
     cssFramework = CSS_FRAMEWORK_DEFAULT,
     appName: rawAppName = 'web',
     tauri = false,
+    i18n = 'none',
+    locales = 'ko,en',
   } = opts;
 
   if (platform === 'flutter') {
@@ -99,6 +103,19 @@ export function describeTemplate(opts = {}) {
         const tauriFiles = tauriTpl.base.map((p) => `src-tauri/${p}`);
         groups.push(makeGroup('tauri', 'Tauri 셸 (src-tauri/)', tauriFiles));
       }
+      if (i18n === 'react-i18next') {
+        const isFsd = safeArchName === 'fsd';
+        const i18nBase = isFsd ? 'src/shared/i18n' : 'src/lib/i18n';
+        const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
+        const localesArr = parseLocalesString(locales);
+        const i18nFiles = [
+          `${i18nBase}/config.ts`,
+          `${i18nBase}/index.ts`,
+          ...localesArr.map((lng) => `${i18nBase}/locales/${lng}/common.json`),
+          `${providersBase}/I18nProvider.tsx`,
+        ];
+        groups.push(makeGroup('i18n', `i18n (${i18n})`, i18nFiles));
+      }
       return finalize(groups);
     }
 
@@ -149,6 +166,20 @@ export function describeTemplate(opts = {}) {
       groups.push(makeGroup('tauri', `Tauri 셸 (apps/${appName}/src-tauri/)`, tauriFiles));
     }
 
+    if (i18n === 'react-i18next') {
+      const isFsd = safeArchName === 'fsd';
+      const i18nBase = isFsd ? 'src/shared/i18n' : 'src/lib/i18n';
+      const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
+      const localesArr = parseLocalesString(locales);
+      const i18nFiles = [
+        `apps/${appName}/${i18nBase}/config.ts`,
+        `apps/${appName}/${i18nBase}/index.ts`,
+        ...localesArr.map((lng) => `apps/${appName}/${i18nBase}/locales/${lng}/common.json`),
+        `apps/${appName}/${providersBase}/I18nProvider.tsx`,
+      ];
+      groups.push(makeGroup('i18n', `i18n (${i18n}, apps/${appName}/)`, i18nFiles));
+    }
+
     return finalize(groups);
   }
 
@@ -326,6 +357,14 @@ function makeGroup(id, label, paths) {
   return { id, label, paths: paths.slice() };
 }
 
+/** locales (string or string[]) 를 정규화 — generator.js 의 parseLocales 와 동일 규칙. */
+function parseLocalesString(s) {
+  if (Array.isArray(s)) return s;
+  if (typeof s !== 'string') return ['ko', 'en'];
+  const arr = s.split(',').map((x) => x.trim().toLowerCase()).filter((x) => /^[a-z]{2}(-[a-z]{2})?$/i.test(x));
+  return arr.length > 0 ? arr : ['ko', 'en'];
+}
+
 /**
  * 후처리: 그룹 간 dedupe (같은 path 가 여러 그룹에 있으면 마지막 그룹이 소유),
  * 그룹 안에서 path 정렬, 빈 그룹 제거, 전체 파일 목록 계산.

package/src/create/generator.js

@@ -224,6 +224,13 @@ export async function createProject(options = {}) {
     }
   }
 
+  // i18n 옵션도 vite preset 전용. v0.92.0+.
+  if (options.i18n && options.i18n !== 'none' && platform !== 'vite') {
+    throw new Error(
+      `i18n='${options.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). --i18n none 또는 --platform vite 사용.`,
+    );
+  }
+
   // arch 결정 — platform 확정 후. 사용자가 --arch 미지정 시:
   //   - next  → DEFAULT_ARCH ('fsd')
   //   - flutter → 현재 Flutter arch 디스크립터 없음 → null. 미래에 flutter arch 추가되면
@@ -344,9 +351,19 @@ export async function createProject(options = {}) {
     });
 
     if (projectType === 'standalone') {
-      await generateViteStandalone(targetDir, projectName, theme, cssFramework, arch, themeBase, { tauri: !!options.tauri });
+      await generateViteStandalone(targetDir, projectName, theme, cssFramework, arch, themeBase, {
+        tauri: !!options.tauri,
+        i18n: options.i18n ?? 'none',
+        locales: options.locales ?? 'ko,en',
+      });
     } else {
-      await generateMonorepo(targetDir, projectName, [], { yes: options.yes, theme, css: cssFramework, arch, themeBase, platform: 'vite', tauri: options.tauri });
+      await generateMonorepo(targetDir, projectName, [], {
+        yes: options.yes, theme, css: cssFramework, arch, themeBase,
+        platform: 'vite',
+        tauri: options.tauri,
+        i18n: options.i18n ?? 'none',
+        locales: options.locales ?? 'ko,en',
+      });
     }
 
     await finalizeProject(targetDir, { dryRun: options.dryRun });
@@ -477,6 +494,42 @@ export async function addApp(options = {}) {
     throw new Error('비대화형 환경(TTY 없음)에서는 name 이 필요합니다.');
   }
 
+  // platform 결정 — 명시 시 그대로, 미지정 시 기존 apps/* 의 package.json 스캔으로 추론.
+  let platform = options.platform;
+  if (!platform) {
+    platform = await inferMonorepoPlatform(cwd);
+    if (!platform) {
+      // 모노레포에 아직 앱이 없거나 혼재 — 안전한 디폴트 (next 가 기존 동작).
+      // 첫 앱은 user 가 명시하는 게 권장 (interactive prompt).
+      if (process.stdin.isTTY) {
+        platform = await select({
+          message: '플랫폼:',
+          choices: [
+            { name: 'Next.js', value: 'next' },
+            { name: 'Vite (SPA)', value: 'vite' },
+          ],
+        });
+      } else {
+        platform = 'next';
+      }
+    }
+  }
+  if (platform !== 'next' && platform !== 'vite') {
+    throw new Error(
+      `add-app 는 platform=next 또는 vite 만 지원 (받은 값: ${platform}). flutter 는 standalone 만 지원.`,
+    );
+  }
+  if (options.tauri && platform !== 'vite') {
+    throw new Error(
+      `tauri 는 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). --platform vite 사용 또는 tauri 옵션 제거.`,
+    );
+  }
+  if (options.i18n && options.i18n !== 'none' && platform !== 'vite') {
+    throw new Error(
+      `i18n='${options.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}).`,
+    );
+  }
+
   const appName = validateProjectName(
     options.name ?? await input({
       message: '앱 이름:',
@@ -523,9 +576,17 @@ export async function addApp(options = {}) {
   // arch 는 모노레포가 처음 만들어질 때 정한 값과 같아야 한다. root config 에 별도
   // 저장 안 해 두므로 일단 DEFAULT_ARCH (fsd) fallback. 향후 root config 에 arch
   // 박아두고 여기서 읽어오는 흐름으로 개선 가능.
-  const arch = assertArchPlatformCompat(DEFAULT_ARCH, 'next');
+  const arch = assertArchPlatformCompat(DEFAULT_ARCH, platform);
 
-  await generateApp(appsDir, appName, port, plugins, arch, css);
+  if (platform === 'vite') {
+    await generateViteApp(appsDir, appName, port, arch, css, {
+      tauri: !!options.tauri,
+      i18n: options.i18n ?? 'none',
+      locales: options.locales ?? 'ko,en',
+    });
+  } else {
+    await generateApp(appsDir, appName, port, plugins, arch, css);
+  }
 
   // monorepo 의 새 ui-app 패키지 — tokens-only role + theme 주입 + cssFramework 패치.
   // generateMonorepo 의 흐름과 정확히 동일.
@@ -538,6 +599,41 @@ export async function addApp(options = {}) {
   console.log(`\n✅ apps/${appName} 이 추가되었습니다!`);
   console.log('\n  pnpm install');
   console.log(`  pnpm --filter ${appName} dev\n`);
+
+  if (platform === 'vite' && options.tauri) {
+    console.log('Tauri 데스크탑 셸:');
+    console.log(`  cd apps/${appName}`);
+    console.log('  pnpm tauri dev     # Rust 처음 빌드는 5~10분 — 캐시 후 5~10초');
+    console.log('  (Rust 미설치 시 https://rustup.rs/ 참고)\n');
+  }
+}
+
+/**
+ * 모노레포의 기존 apps/* 들 package.json 을 스캔해 platform 추론.
+ * - 모든 앱이 vite — 'vite'
+ * - 모든 앱이 next — 'next'
+ * - 혼재 또는 다른 조합 — null (user 가 명시해야 함)
+ * - apps/ 가 없거나 비었으면 null
+ */
+async function inferMonorepoPlatform(cwd) {
+  const appsDir = path.resolve(cwd, 'apps');
+  if (!(await fs.pathExists(appsDir))) return null;
+  const entries = await fsp.readdir(appsDir, { withFileTypes: true });
+  const apps = entries.filter((e) => e.isDirectory());
+  if (apps.length === 0) return null;
+
+  const platforms = new Set();
+  for (const app of apps) {
+    const pkgPath = path.join(appsDir, app.name, 'package.json');
+    if (!(await fs.pathExists(pkgPath))) continue;
+    const pkg = await fs.readJson(pkgPath);
+    const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+    if (deps.next) platforms.add('next');
+    else if (deps.vite) platforms.add('vite');
+  }
+
+  if (platforms.size === 1) return [...platforms][0];
+  return null;
 }
 
 // ─── Add component to ui packages ───
@@ -750,7 +846,7 @@ async function generateStandalone(targetDir, projectName, plugins, theme, css, a
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
 }
 
-async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { tauri = false } = {}) {
+async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateStandalone 과 같은 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-standalone'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -791,6 +887,11 @@ async function generateViteStandalone(targetDir, projectName, theme, css, arch,
     await emitTauri(targetDir, projectName, { devPort: 5173 });
     await patchViteForTauri(targetDir, { port: 5173 });
   }
+
+  if (i18n === 'react-i18next') {
+    const localesArr = parseLocales(locales);
+    await emitI18n(targetDir, { arch, locales: localesArr });
+  }
 }
 
 /**
@@ -888,7 +989,145 @@ export default defineConfig({
   }
 }
 
-async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false } = {}) {
+/**
+ * react-i18next 셋업을 emit. arch 에 따라 경로가 달라짐:
+ *  - fsd: src/shared/i18n/* + src/app/providers/I18nProvider.tsx
+ *  - flat: src/lib/i18n/* + src/components/providers/I18nProvider.tsx
+ *
+ * 1. i18n/config.ts + i18n/index.ts + locales/{locale}/common.json 생성
+ * 2. providers/I18nProvider.tsx 생성 (<I18nextProvider> wrapper)
+ * 3. GlobalProvider/index.tsx 를 I18nProvider 로 wrapping 하도록 rewrite
+ * 4. package.json 에 i18next 패키지 deps 추가
+ *
+ * @param {string} targetDir — 앱 디렉토리 (standalone 이면 프로젝트 루트, monorepo 이면 apps/{name}/)
+ * @param {object} opts
+ * @param {object} opts.arch — arch descriptor (name + paths/aliases)
+ * @param {string[]} opts.locales — 생성할 locale 코드 배열 (예: ['ko', 'en'])
+ */
+async function emitI18n(targetDir, { arch, locales }) {
+  if (!locales || locales.length === 0) {
+    throw new Error('emitI18n: locales 배열이 비어 있습니다.');
+  }
+
+  const isFsd = arch.name === 'fsd';
+  const i18nDirRel = isFsd ? 'src/shared/i18n' : 'src/lib/i18n';
+  const i18nAlias = isFsd ? '@/shared/i18n' : '@/lib/i18n';
+  const providersDirRel = isFsd ? 'src/app/providers' : 'src/components/providers';
+  const apiAlias = isFsd ? '@/shared/api/queryClient' : '@/lib/api/queryClient';
+
+  const i18nDir = path.join(targetDir, i18nDirRel);
+  await fs.ensureDir(i18nDir);
+  await fs.ensureDir(path.join(i18nDir, 'locales'));
+
+  const localesArr = JSON.stringify(locales);
+  const fallbackLng = locales[0];
+  const configTs = `import i18n from 'i18next';
+import LanguageDetector from 'i18next-browser-languagedetector';
+import HttpBackend from 'i18next-http-backend';
+import { initReactI18next } from 'react-i18next';
+
+// 클라이언트 측 lazy-load — 빌드 산출물에서 public/locales/{lng}/{ns}.json 경로로 fetch.
+// dev 에선 vite 가 ${i18nDirRel}/locales/* 를 /locales 로 serve (vite.config 의 publicDir 기본 'public').
+// 프로덕션 빌드 시 사용자가 vite-plugin-static-copy 등으로 public/locales 로 카피하거나
+// 처음부터 public/locales 에 두면 됨. 디폴트 경로 ${i18nDirRel}/locales 는 dev 편의용.
+
+i18n
+  .use(HttpBackend)
+  .use(LanguageDetector)
+  .use(initReactI18next)
+  .init({
+    fallbackLng: '${fallbackLng}',
+    supportedLngs: ${localesArr},
+    ns: ['common'],
+    defaultNS: 'common',
+    interpolation: { escapeValue: false },
+    backend: {
+      loadPath: '/locales/{{lng}}/{{ns}}.json',
+    },
+    detection: {
+      order: ['localStorage', 'navigator', 'htmlTag'],
+      caches: ['localStorage'],
+    },
+  });
+
+export default i18n;
+`;
+  await fs.writeFile(path.join(i18nDir, 'config.ts'), configTs);
+
+  await fs.writeFile(
+    path.join(i18nDir, 'index.ts'),
+    `export { default } from './config';\n`,
+  );
+
+  for (const lng of locales) {
+    const localeDir = path.join(i18nDir, 'locales', lng);
+    await fs.ensureDir(localeDir);
+    const seed = lng === fallbackLng
+      ? { greeting: 'Hello World', app_title: 'sh-ui app' }
+      : {};
+    await fs.writeFile(
+      path.join(localeDir, 'common.json'),
+      JSON.stringify(seed, null, 2) + '\n',
+    );
+  }
+
+  const providersDir = path.join(targetDir, providersDirRel);
+  await fs.ensureDir(providersDir);
+  const i18nProvider = `import { type ReactNode } from 'react';
+import { I18nextProvider } from 'react-i18next';
+import i18n from '${i18nAlias}';
+
+export function I18nProvider({ children }: { children: ReactNode }) {
+  return <I18nextProvider i18n={i18n}>{children}</I18nextProvider>;
+}
+`;
+  await fs.writeFile(path.join(providersDir, 'I18nProvider.tsx'), i18nProvider);
+
+  const globalProviderPath = path.join(targetDir, providersDirRel, 'GlobalProvider', 'index.tsx');
+  const globalProvider = `import { QueryClientProvider } from '@tanstack/react-query';
+import { type ReactNode, useState } from 'react';
+import { createQueryClient } from '${apiAlias}';
+import { ThemeProvider } from '../theme/ThemeProvider';
+import { I18nProvider } from '../I18nProvider';
+
+export function GlobalProvider({ children }: { children: ReactNode }) {
+  const [queryClient] = useState(() => createQueryClient());
+  return (
+    <I18nProvider>
+      <ThemeProvider>
+        <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+      </ThemeProvider>
+    </I18nProvider>
+  );
+}
+`;
+  await fs.writeFile(globalProviderPath, globalProvider);
+
+  const pkgPath = path.join(targetDir, 'package.json');
+  const pkg = await fs.readJson(pkgPath);
+  pkg.dependencies = pkg.dependencies ?? {};
+  pkg.dependencies['i18next'] = '^23.15.1';
+  pkg.dependencies['i18next-browser-languagedetector'] = '^8.0.0';
+  pkg.dependencies['i18next-http-backend'] = '^2.7.1';
+  pkg.dependencies['react-i18next'] = '^15.1.0';
+  pkg.dependencies = sortObjectKeys(pkg.dependencies);
+  await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+}
+
+/**
+ * locales 인자 (string or string[]) 를 정규화. comma-separated 또는 array 모두 받음.
+ * 빈 값 / 잘못된 형식이면 디폴트 ['ko', 'en'] fallback.
+ */
+function parseLocales(input) {
+  let arr;
+  if (Array.isArray(input)) arr = input;
+  else if (typeof input === 'string') arr = input.split(',');
+  else arr = ['ko', 'en'];
+  const cleaned = arr.map((s) => s.trim().toLowerCase()).filter((s) => /^[a-z]{2}(-[a-z]{2})?$/i.test(s));
+  return cleaned.length > 0 ? cleaned : ['ko', 'en'];
+}
+
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -920,7 +1159,7 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
 
   const appsDir = path.join(targetDir, 'apps', appName);
   if (platform === 'vite') {
-    await generateViteApp(appsDir, appName, port, arch, css, { tauri });
+    await generateViteApp(appsDir, appName, port, arch, css, { tauri, i18n, locales });
   } else {
     await generateApp(appsDir, appName, port, plugins, arch, css);
   }
@@ -1021,7 +1260,7 @@ async function generateApp(targetDir, appName, port, plugins, arch, css = 'tailw
   }
 }
 
-async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { tauri = false } = {}) {
+async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateApp 과 동일 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-app'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -1089,6 +1328,11 @@ async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind',
     await emitTauri(targetDir, appName, { devPort });
     await patchViteForTauri(targetDir, { port: devPort });
   }
+
+  if (i18n === 'react-i18next') {
+    const localesArr = parseLocales(locales);
+    await emitI18n(targetDir, { arch, locales: localesArr });
+  }
 }
 
 /**

package/src/create/index.mjs

@@ -18,7 +18,7 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
 
 사용법:
   sh-ui create [name] [options]
-  sh-ui create add-app [name] [--port <n>] [--plugins ..] [--theme ..] [--css ..]
+  sh-ui create add-app [name] [--port <n>] [--platform <next|vite>] [--plugins ..] [--theme ..] [--css ..] [--tauri] [--i18n <react-i18next|none>] [--locales ko,en]
   sh-ui create add-component <name> [--app <name>]
 
 옵션:
@@ -28,6 +28,8 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
   --plugins <a,b>                    플러그인 (${PLUGINS_LIST}). 미지정/"" → 없음
   --theme <preset|base64>            프리셋 이름(${THEME_PRESETS_LIST}) 또는 playground base64. 선택
   --css <${CSS_FRAMEWORKS_SUPPORTED.join('|')}>                        CSS 프레임워크. base 파일까지 분기 emit (tailwind/plain/css-modules)
+  --i18n <react-i18next|none>        vite 전용 — react-i18next 셋업 emit (i18n config + I18nProvider). 기본 none (v0.92.0+)
+  --locales <ko,en>                  i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en'
   --yes                              디렉토리 덮어쓰기 + 모노레포 기본값 자동 채택
   --dry-run                          파일을 쓰지 않고 작성될 파일 목록만 출력
   -h, --help                         이 도움말
@@ -73,6 +75,10 @@ export async function runCreate(rest) {
       plugins: flags.plugins,
       theme: flags.theme,
       css: flags.css,
+      platform: flags.platform,
+      tauri: flags.tauri,
+      i18n: flags.i18n,
+      locales: flags.locales,
     });
   } else if (command === 'add-component') {
     // 호환 별칭 — 신규 진입점은 `sh-ui add <name>` (bin/sh-ui.mjs 가 walk-up 으로 라우팅).
@@ -90,6 +96,8 @@ export async function runCreate(rest) {
       theme: flags.theme,
       css: flags.css,
       tauri: flags.tauri,
+      i18n: flags.i18n,
+      locales: flags.locales,
       yes: flags.yes,
       dryRun: flags.dryRun,
     });

package/src/mcp.mjs

@@ -46,6 +46,8 @@ import {
   THEME_RADII,
   THEME_MODES,
   CSS_FRAMEWORKS_SUPPORTED,
+  I18N_LIBRARIES,
+  I18N_DEFAULT_LOCALES,
 } from "./constants.js";
 import { allPlugins } from "./create/plugins/index.js";
 import { allArchitectures } from "./create/architectures/index.js";
@@ -402,6 +404,16 @@ export async function startMcpServer() {
             "Rust toolchain (`cargo`/`rustc`) 가 시스템에 설치되어 있어야 첫 `pnpm tauri dev` 가 동작. " +
             "기본 false.",
           ),
+        i18n: z.enum(I18N_LIBRARIES).optional()
+          .describe(
+            "i18n 라이브러리 — platform=vite 일 때만 의미. 'react-i18next' 로 설정 시 i18next + react-i18next + browser-languagedetector + http-backend 셋업 + " +
+            "providers/I18nProvider.tsx + locales/{lng}/common.json 자동 emit. 기본 'none'. v0.92.0+ 신규.",
+          ),
+        locales: z.string().optional()
+          .describe(
+            `i18n 활성화 시 생성할 locale 코드 (comma-separated, 2글자 또는 'ko-KR' 류). 기본 '${I18N_DEFAULT_LOCALES}'. 첫 locale 이 fallbackLng. ` +
+            "i18n='none' 이면 무시.",
+          ),
       },
     },
     async (input) => {
@@ -432,6 +444,15 @@ export async function startMcpServer() {
           }],
         };
       }
+      if (input.i18n && input.i18n !== "none" && input.platform !== "vite") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: `i18n='${input.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${input.platform}).`,
+          }],
+        };
+      }
       const targetParent = resolveCwd(input);
       const targetDir = resolve(targetParent, input.name);
       if (existsSync(targetDir) && !input.force) {
@@ -458,6 +479,8 @@ export async function startMcpServer() {
             theme: input.theme,
             css: input.cssFramework,
             tauri: input.tauri,
+            i18n: input.i18n,
+            locales: input.locales,
             yes: true, // 사전 검사를 마쳤으니 generator 의 confirm 프롬프트 우회
           }),
         );
@@ -472,10 +495,11 @@ export async function startMcpServer() {
     "sh_ui_add_app",
     {
       description:
-        "기존 모노레포에 새 Next.js 앱 추가 — apps/{name}/ + packages/ui/ui-apps/ui-{name}/ 동시 생성. " +
+        "기존 모노레포에 새 앱 (Next.js 또는 Vite) 추가 — apps/{name}/ + packages/ui/ui-apps/ui-{name}/ 동시 생성. " +
         "사용자가 '앱 추가' / 'monorepo 에 새 앱' / 'add admin app' 류 요청을 하면 이 툴 사용 (Bash 로 npx " + cliName + " add-app 직접 호출보다 우선). " +
         "v0.65+ 레이아웃 준수 — ui-{name} 은 tokens-only role, 컴포넌트는 sibling ui-core 가 SoT. " +
-        "theme/css 는 새 ui-app 에만 적용 (다른 앱 영향 없음). monorepo 가 아니면 (pnpm-workspace.yaml 없음) 에러.",
+        "theme/css 는 새 ui-app 에만 적용 (다른 앱 영향 없음). monorepo 가 아니면 (pnpm-workspace.yaml 없음) 에러. " +
+        "platform 미지정 시 기존 apps/* 스캔해 추론 (모든 앱이 같은 플랫폼이면 그것으로). vite + tauri:true 면 apps/{name}/src-tauri/ 도 함께 emit.",
       inputSchema: {
         name: z.string().min(1)
           .describe("앱 이름 — apps/{name}/ + packages/ui/ui-apps/ui-{name}/ 디렉토리명. 영숫자 + 하이픈."),
@@ -487,6 +511,19 @@ export async function startMcpServer() {
           .describe(`프리셋 이름 (${THEME_PRESETS_LIST}) 또는 base64 테마 코드. 새 ui-app 의 tokens.css 에만 주입.`),
         cssFramework: z.enum(CSS_FRAMEWORKS).optional()
           .describe("CSS 프레임워크. 기본 plain. 새 앱의 컴포넌트 변종 결정 — 같은 모노레포 내 다른 앱과 다른 값 가능."),
+        platform: z.enum(["next", "vite"]).optional()
+          .describe("플랫폼 — next | vite. 미지정 시 기존 apps/* 의 deps 로 추론 (모든 앱이 같은 플랫폼이면 그것으로, 혼재면 명시 필요)."),
+        tauri: z.boolean().optional()
+          .describe("Tauri 2.x 데스크탑 셸 — platform=vite 일 때만 의미. apps/{name}/src-tauri/ 에 emit. 기본 false."),
+        i18n: z.enum(I18N_LIBRARIES).optional()
+          .describe(
+            "i18n 라이브러리 — platform=vite 일 때만 의미. 'react-i18next' 로 설정 시 i18next + react-i18next + " +
+            "browser-languagedetector + http-backend 셋업 + providers/I18nProvider.tsx 자동 emit. 기본 'none'. v0.92.0+ 신규.",
+          ),
+        locales: z.string().optional()
+          .describe(
+            `i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 '${I18N_DEFAULT_LOCALES}'. 첫 locale 이 fallbackLng. i18n='none' 이면 무시.`,
+          ),
         cwd: z.string().optional()
           .describe("모노레포 루트 (pnpm-workspace.yaml 있는 곳). 기본 process.cwd()"),
       },
@@ -497,6 +534,24 @@ export async function startMcpServer() {
       } catch (e) {
         return { isError: true, content: [{ type: "text", text: e.message }] };
       }
+      if (input.tauri && input.platform === "next") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: "tauri 는 platform=vite 일 때만 지원합니다. --platform vite 사용 또는 tauri 옵션 제거.",
+          }],
+        };
+      }
+      if (input.i18n && input.i18n !== "none" && input.platform && input.platform !== "vite") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: `i18n='${input.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${input.platform}).`,
+          }],
+        };
+      }
       const text = await captureConsole(() =>
         addApp({
           name: input.name,
@@ -504,6 +559,10 @@ export async function startMcpServer() {
           plugins: input.plugins,
           theme: input.theme,
           css: input.cssFramework,
+          platform: input.platform,
+          tauri: input.tauri,
+          i18n: input.i18n,
+          locales: input.locales,
           cwd: resolveCwd(input),
         }),
       );