create-jsonlink 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# create-jsonlink
+
+The official starter and initialization CLI for **[JSON Link](https://json-link.pages.dev)**.
+
+Scaffold a high-performance React + Vite + TypeScript application preconfigured with the JSON Link localization workspace, or initialize JSON Link into any existing React project with a single command.
+
+---
+
+## Usage
+
+### Option 1: Create a New Localized App (Zero Setup)
+
+```bash
+npm create jsonlink my-i18n-app
+# or
+npx create-jsonlink my-i18n-app
+```
+
+Then start your app:
+
+```bash
+cd my-i18n-app
+npm install
+npm run dev
+```
+
+- **App**: `http://localhost:5173`
+- **JSON Link Live Dashboard**: `http://localhost:5173/__jsonlink`
+
+---
+
+### Option 2: Initialize in an Existing Vite Project
+
+Run inside any existing React + Vite repository root:
+
+```bash
+npx create-jsonlink
+```
+
+This will automatically:
+1. Detect your package manager (`npm`, `pnpm`, `bun`, `yarn`).
+2. Inject `jsonLink()` into your `vite.config.ts`.
+3. Add `@jsonlink/vite-plugin` to `devDependencies`.
+4. Scaffold `src/locales/` (`en.json`, `my.json`, `translations.d.ts`, `i18n.ts`).
+
+---
+
+## What is Included?
+
+- **Vite Devtool Plugin**: Two-way disk synchronization with instant Vite HMR.
+- **Embedded Dev Dashboard**: Full spreadsheet localization table at `http://localhost:5173/__jsonlink`.
+- **Zero Runtime Overhead**: The devtool runs strictly during `vite dev` and tree-shakes completely out of production builds.
+- **Type-Safe Autocomplete**: Full TypeScript definition generation (`translations.d.ts`) for key names and variable interpolations.
+- **Lossless Myanmar Support**: Built-in Unicode and Zawgyi font handling.
+
+---
+
+## License
+
+MIT © [Pyae Phyo Maung](https://github.com/pyaephyomaungdev/json-link)

package/bin/create-jsonlink.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { runCli } from '../dist/index.js';
+
+runCli();

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { initExistingProject, findViteConfig, detectPackageManager } from './initExisting.js';
+import { scaffoldStarterProject } from './scaffoldStarter.js';
+export { initExistingProject, scaffoldStarterProject, detectPackageManager, findViteConfig };
+export declare function runCli(argv?: string[]): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC;AAE7F,wBAAgB,MAAM,CAAC,IAAI,WAAwB,GAAG,IAAI,CAqGzD"}

package/dist/index.js

@@ -0,0 +1,93 @@
+import path from 'node:path';
+import { initExistingProject, findViteConfig, detectPackageManager } from './initExisting.js';
+import { scaffoldStarterProject } from './scaffoldStarter.js';
+export { initExistingProject, scaffoldStarterProject, detectPackageManager, findViteConfig };
+export function runCli(argv = process.argv.slice(2)) {
+    const args = argv.filter(a => !a.startsWith('-'));
+    const flags = new Set(argv.filter(a => a.startsWith('-')));
+    if (flags.has('--help') || flags.has('-h')) {
+        console.log(`
+\x1b[36m⚡ create-jsonlink\x1b[0m — Instant local-first localization for React + Vite
+
+\x1b[1mUsage:\x1b[0m
+  npm create jsonlink [project-name]
+  npx create-jsonlink [project-name]
+
+\x1b[1mModes:\x1b[0m
+  1. \x1b[32mNew Project Mode:\x1b[0m
+     npx create-jsonlink my-i18n-app
+     Scaffolds a complete React + TypeScript + Vite project preconfigured with JSON Link.
+
+  2. \x1b[32mExisting Project Mode:\x1b[0m
+     npx create-jsonlink
+     (Run inside an existing Vite project root to inject plugin and scaffold locales)
+`);
+        process.exit(0);
+    }
+    const projectName = args[0];
+    const cwd = process.cwd();
+    // Mode 1: Project name provided -> Scaffold new starter app
+    if (projectName) {
+        const targetDir = path.resolve(cwd, projectName);
+        console.log(`\n\x1b[36m⚡ Creating a new JSON Link localized project in\x1b[0m \x1b[1m${targetDir}\x1b[0m...\n`);
+        const result = scaffoldStarterProject({ targetDir, projectName });
+        if (!result.success) {
+            console.error(`\x1b[31m✖ ${result.message}\x1b[0m\n`);
+            process.exit(1);
+        }
+        console.log(`\x1b[32m✔\x1b[0m Project created successfully!`);
+        console.log(`\x1b[32m✔\x1b[0m React 19 + TypeScript + Vite configured`);
+        console.log(`\x1b[32m✔\x1b[0m JSON Link plugin and reactive i18n client scaffolded\n`);
+        console.log(`\x1b[1mNext steps:\x1b[0m`);
+        console.log(`  cd \x1b[36m${projectName}\x1b[0m`);
+        console.log(`  \x1b[36mnpm install\x1b[0m`);
+        console.log(`  \x1b[36mnpm run dev\x1b[0m\n`);
+        console.log(`Open in browser:`);
+        console.log(`  App:            \x1b[36mhttp://localhost:5173\x1b[0m`);
+        console.log(`  Live Devtool:   \x1b[36mhttp://localhost:5173/__jsonlink\x1b[0m\n`);
+        return;
+    }
+    // Mode 2: No argument provided -> Check if current folder is a Vite project
+    const existingViteConfig = findViteConfig(cwd);
+    if (existingViteConfig) {
+        console.log(`\n\x1b[36m⚡ Existing Vite project detected. Initializing JSON Link...\x1b[0m\n`);
+        const pm = detectPackageManager(cwd);
+        const result = initExistingProject(cwd);
+        if (!result.success) {
+            console.error(`\x1b[31m✖ ${result.message}\x1b[0m\n`);
+            process.exit(1);
+        }
+        console.log(`\x1b[32m✔\x1b[0m Injected JSON Link plugin into \x1b[1m${result.viteConfigFile}\x1b[0m`);
+        if (result.localesCreated) {
+            console.log(`\x1b[32m✔\x1b[0m Created \x1b[1msrc/locales/\x1b[0m (en.json, my.json, translations.d.ts, i18n.ts)`);
+        }
+        else {
+            console.log(`\x1b[33mℹ\x1b[0m Existing \x1b[1msrc/locales/\x1b[0m preserved`);
+        }
+        if (result.packageUpdated) {
+            console.log(`\x1b[32m✔\x1b[0m Added \x1b[1m@jsonlink/vite-plugin\x1b[0m to devDependencies in package.json`);
+        }
+        console.log(`\n\x1b[32m\x1b[1m🎉 JSON Link Dev Dashboard is ready!\x1b[0m\n`);
+        console.log(`Run your dev server:`);
+        console.log(`  \x1b[36m${pm === 'npm' ? 'npm run dev' : `${pm} dev`}\x1b[0m\n`);
+        console.log(`Open translation workspace:`);
+        console.log(`  👉 \x1b[36mhttp://localhost:5173/__jsonlink\x1b[0m\n`);
+        return;
+    }
+    // Mode 3: Neither project name nor Vite config in current dir -> Default starter in ./jsonlink-app
+    const defaultDir = 'jsonlink-app';
+    const targetDir = path.resolve(cwd, defaultDir);
+    console.log(`\n\x1b[36m⚡ No Vite project detected in current directory.\x1b[0m`);
+    console.log(`Scaffolding a new starter app in \x1b[1m./${defaultDir}\x1b[0m...\n`);
+    const result = scaffoldStarterProject({ targetDir, projectName: defaultDir });
+    if (!result.success) {
+        console.error(`\x1b[31m✖ ${result.message}\x1b[0m\n`);
+        process.exit(1);
+    }
+    console.log(`\x1b[32m✔\x1b[0m Project created successfully!`);
+    console.log(`\n\x1b[1mNext steps:\x1b[0m`);
+    console.log(`  cd \x1b[36m${defaultDir}\x1b[0m`);
+    console.log(`  \x1b[36mnpm install\x1b[0m`);
+    console.log(`  \x1b[36mnpm run dev\x1b[0m\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/initExisting.d.ts

@@ -0,0 +1,17 @@
+export interface InitExistingResult {
+    success: boolean;
+    viteConfigFile?: string;
+    localesCreated?: boolean;
+    packageUpdated?: boolean;
+    message?: string;
+}
+export declare function detectPackageManager(targetDir: string): 'pnpm' | 'yarn' | 'bun' | 'npm';
+export declare function findViteConfig(targetDir: string): string | null;
+export declare function injectVitePlugin(configContent: string): {
+    content: string;
+    changed: boolean;
+};
+export declare function scaffoldLocales(targetDir: string): boolean;
+export declare function ensurePluginDependency(targetDir: string): boolean;
+export declare function initExistingProject(targetDir?: string): InitExistingResult;
+//# sourceMappingURL=initExisting.d.ts.map

package/dist/initExisting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initExisting.d.ts","sourceRoot":"","sources":["../src/initExisting.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAKvF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB/D;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAqB7F;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAyI1D;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAkBjE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,SAAgB,GAAG,kBAAkB,CAwBjF"}

package/dist/initExisting.js

@@ -0,0 +1,219 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function detectPackageManager(targetDir) {
+    if (fs.existsSync(path.join(targetDir, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (fs.existsSync(path.join(targetDir, 'bun.lockb')) || fs.existsSync(path.join(targetDir, 'bun.lock')))
+        return 'bun';
+    if (fs.existsSync(path.join(targetDir, 'yarn.lock')))
+        return 'yarn';
+    return 'npm';
+}
+export function findViteConfig(targetDir) {
+    const possibleFiles = [
+        'vite.config.ts',
+        'vite.config.js',
+        'vite.config.mjs',
+        'vite.config.mts',
+    ];
+    for (const file of possibleFiles) {
+        const fullPath = path.join(targetDir, file);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+export function injectVitePlugin(configContent) {
+    if (configContent.includes('jsonLink(') || configContent.includes('@jsonlink/vite-plugin')) {
+        return { content: configContent, changed: false };
+    }
+    let updated = configContent;
+    const importStatement = "import { jsonLink } from '@jsonlink/vite-plugin';\n";
+    updated = importStatement + updated;
+    const pluginsRegex = /plugins\s*:\s*\[/;
+    if (pluginsRegex.test(updated)) {
+        updated = updated.replace(pluginsRegex, 'plugins: [\n    jsonLink(),');
+    }
+    else {
+        const defineRegex = /defineConfig\s*\(\s*\{/;
+        if (defineRegex.test(updated)) {
+            updated = updated.replace(defineRegex, 'defineConfig({\n  plugins: [jsonLink()],');
+        }
+    }
+    return { content: updated, changed: true };
+}
+export function scaffoldLocales(targetDir) {
+    const localesDir = path.join(targetDir, 'src', 'locales');
+    if (fs.existsSync(localesDir)) {
+        return false;
+    }
+    fs.mkdirSync(localesDir, { recursive: true });
+    const enData = {
+        "app.title": "My Localized App",
+        "app.description": "A modern multilingual application with JSON Link and React.",
+        "auth.welcome": "Welcome back, {username}!",
+        "common.save": "Save Changes",
+        "common.cancel": "Cancel",
+        "common.switch_language": "Language",
+        "common.english": "English",
+        "common.myanmar": "မြန်မာ"
+    };
+    fs.writeFileSync(path.join(localesDir, 'en.json'), JSON.stringify(enData, null, 2) + '\n');
+    const myData = {
+        "app.title": "ကျွန်ုပ်၏အက်ပ်",
+        "app.description": "JSON Link နှင့် React ဖြင့် တည်ဆောက်ထားသော ဘာသာစကားစုံသုံး အက်ပ်။",
+        "auth.welcome": "ကြိုဆိုပါတယ် {username}!",
+        "common.save": "သိမ်းဆည်းမည်",
+        "common.cancel": "မလုပ်တော့ပါ",
+        "common.switch_language": "ဘာသာစကား",
+        "common.english": "English",
+        "common.myanmar": "မြန်မာ"
+    };
+    fs.writeFileSync(path.join(localesDir, 'my.json'), JSON.stringify(myData, null, 2) + '\n');
+    const defaultKeys = Object.keys(enData);
+    const dtsContent = `export type SupportedLanguage = "en" | "my";
+
+export type TranslationKey =
+${defaultKeys.map(k => `  | ${JSON.stringify(k)}`).join('\n')};
+
+export interface TranslationDictionary {
+  [key: string]: string;
+}
+`;
+    fs.writeFileSync(path.join(localesDir, 'translations.d.ts'), dtsContent);
+    const i18nContent = `import { useSyncExternalStore } from 'react';
+import type { SupportedLanguage, TranslationKey } from './translations';
+import en from './en.json';
+import my from './my.json';
+
+export const SUPPORTED_LANGUAGES: SupportedLanguage[] = ['en', 'my'];
+
+export const resources: Record<SupportedLanguage, Record<string, any>> = {
+  'en': en,
+  'my': my,
+};
+
+let currentLanguage: SupportedLanguage = 'en';
+const listeners = new Set<() => void>();
+
+function notify() {
+  listeners.forEach((listener) => listener());
+}
+
+export function setLanguage(lang: SupportedLanguage): void {
+  if (resources[lang]) {
+    currentLanguage = lang;
+    notify();
+  }
+}
+
+export function getLanguage(): SupportedLanguage {
+  return currentLanguage;
+}
+
+function resolveValue(obj: Record<string, any>, key: string): string | undefined {
+  if (!obj) return undefined;
+  if (obj[key] !== undefined) return String(obj[key]);
+  const parts = key.split('.');
+  let current: any = obj;
+  for (const part of parts) {
+    if (current && typeof current === 'object' && part in current) {
+      current = current[part];
+    } else {
+      return undefined;
+    }
+  }
+  return typeof current === 'string' ? current : undefined;
+}
+
+export function t(
+  key: TranslationKey | (string & {}),
+  params?: Record<string, string | number>,
+  lang?: SupportedLanguage
+): string {
+  const activeLang = lang || currentLanguage;
+  const dict = resources[activeLang] || resources['en'] || {};
+  let text = resolveValue(dict, key);
+
+  if (text === undefined) {
+    text = resolveValue(resources['en'] || {}, key) ?? key;
+  }
+
+  if (params && typeof text === 'string') {
+    return text.replace(/\\{([a-zA-Z0-9_]+)\\}/g, (_, varName) => {
+      return params[varName] !== undefined ? String(params[varName]) : \`{\${varName}}\`;
+    });
+  }
+
+  return text;
+}
+
+export function useTranslation() {
+  const lang = useSyncExternalStore(
+    (callback) => {
+      listeners.add(callback);
+      return () => listeners.delete(callback);
+    },
+    () => currentLanguage
+  );
+
+  return {
+    t,
+    language: lang,
+    setLanguage,
+    languages: SUPPORTED_LANGUAGES,
+  };
+}
+
+if (import.meta.hot) {
+  import.meta.hot.accept((newModule) => {
+    if (newModule) notify();
+  });
+}
+`;
+    fs.writeFileSync(path.join(localesDir, 'i18n.ts'), i18nContent);
+    return true;
+}
+export function ensurePluginDependency(targetDir) {
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return false;
+    try {
+        const raw = fs.readFileSync(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        pkg.devDependencies = pkg.devDependencies || {};
+        if (!pkg.devDependencies['@jsonlink/vite-plugin']) {
+            pkg.devDependencies['@jsonlink/vite-plugin'] = '^1.0.0';
+            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+            return true;
+        }
+    }
+    catch {
+        // Ignore JSON parse errors
+    }
+    return false;
+}
+export function initExistingProject(targetDir = process.cwd()) {
+    const configPath = findViteConfig(targetDir);
+    if (!configPath) {
+        return {
+            success: false,
+            message: 'No Vite configuration found (vite.config.ts/js).',
+        };
+    }
+    const rawConfig = fs.readFileSync(configPath, 'utf-8');
+    const { content: updatedConfig, changed } = injectVitePlugin(rawConfig);
+    if (changed) {
+        fs.writeFileSync(configPath, updatedConfig, 'utf-8');
+    }
+    const localesCreated = scaffoldLocales(targetDir);
+    const packageUpdated = ensurePluginDependency(targetDir);
+    return {
+        success: true,
+        viteConfigFile: path.basename(configPath),
+        localesCreated,
+        packageUpdated,
+    };
+}
+//# sourceMappingURL=initExisting.js.map

package/dist/initExisting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initExisting.js","sourceRoot":"","sources":["../src/initExisting.ts"],"names":[],"mappings":"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"}

package/dist/scaffoldStarter.d.ts

@@ -0,0 +1,9 @@
+export interface StarterOptions {
+    targetDir: string;
+    projectName: string;
+}
+export declare function scaffoldStarterProject(options: StarterOptions): {
+    success: boolean;
+    message?: string;
+};
+//# sourceMappingURL=scaffoldStarter.d.ts.map

package/dist/scaffoldStarter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffoldStarter.d.ts","sourceRoot":"","sources":["../src/scaffoldStarter.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CA6iBtG"}

package/dist/scaffoldStarter.js

@@ -0,0 +1,542 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function scaffoldStarterProject(options) {
+    const { targetDir, projectName } = options;
+    if (fs.existsSync(targetDir)) {
+        const files = fs.readdirSync(targetDir);
+        if (files.length > 0) {
+            return {
+                success: false,
+                message: `Target directory "${projectName}" is not empty. Please use an empty directory or existing Vite project.`,
+            };
+        }
+    }
+    else {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+    // 1. package.json
+    const packageJson = {
+        name: projectName,
+        private: true,
+        version: "0.1.0",
+        type: "module",
+        scripts: {
+            dev: "vite",
+            build: "tsc -b && vite build",
+            preview: "vite preview"
+        },
+        dependencies: {
+            react: "^19.0.0",
+            "react-dom": "^19.0.0",
+            "lucide-react": "^1.16.0"
+        },
+        devDependencies: {
+            "@jsonlink/vite-plugin": "^1.0.0",
+            "@types/react": "^19.0.10",
+            "@types/react-dom": "^19.0.4",
+            "@vitejs/plugin-react": "^4.3.4",
+            typescript: "~5.7.2",
+            vite: "^6.2.0"
+        }
+    };
+    fs.writeFileSync(path.join(targetDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
+    // 2. vite.config.ts
+    const viteConfig = `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { jsonLink } from '@jsonlink/vite-plugin';
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [
+    react(),
+    jsonLink({
+      localesDir: './src/locales',
+      route: '/__jsonlink',
+    }),
+  ],
+});
+`;
+    fs.writeFileSync(path.join(targetDir, 'vite.config.ts'), viteConfig);
+    // 3. tsconfig.json, tsconfig.app.json, tsconfig.node.json
+    const tsconfig = {
+        files: [],
+        references: [
+            { path: "./tsconfig.app.json" },
+            { path: "./tsconfig.node.json" }
+        ]
+    };
+    fs.writeFileSync(path.join(targetDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2) + '\n');
+    const tsconfigApp = {
+        compilerOptions: {
+            target: "ES2020",
+            useDefineForClassFields: true,
+            lib: ["ES2020", "DOM", "DOM.Iterable"],
+            module: "ESNext",
+            skipLibCheck: true,
+            moduleResolution: "bundler",
+            allowImportingTsExtensions: false,
+            isolatedModules: true,
+            moduleDetection: "force",
+            noEmit: true,
+            jsx: "react-jsx",
+            strict: true,
+            noUnusedLocals: true,
+            noUnusedParameters: true,
+            noFallthroughCasesInSwitch: true
+        },
+        include: ["src"]
+    };
+    fs.writeFileSync(path.join(targetDir, 'tsconfig.app.json'), JSON.stringify(tsconfigApp, null, 2) + '\n');
+    const tsconfigNode = {
+        compilerOptions: {
+            target: "ES2022",
+            lib: ["ES2023"],
+            module: "ESNext",
+            skipLibCheck: true,
+            moduleResolution: "bundler",
+            isolatedModules: true,
+            moduleDetection: "force",
+            noEmit: true,
+            strict: true
+        },
+        include: ["vite.config.ts"]
+    };
+    fs.writeFileSync(path.join(targetDir, 'tsconfig.node.json'), JSON.stringify(tsconfigNode, null, 2) + '\n');
+    // 4. index.html
+    const indexHtml = `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Noto+Sans+Myanmar:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <title>JSON Link App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+    fs.writeFileSync(path.join(targetDir, 'index.html'), indexHtml);
+    // 5. src directory
+    const srcDir = path.join(targetDir, 'src');
+    fs.mkdirSync(srcDir, { recursive: true });
+    // 6. src/index.css
+    const indexCss = `:root {
+  font-family: 'Inter', 'Noto Sans Myanmar', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  line-height: 1.5;
+  font-weight: 400;
+  color-scheme: dark light;
+  color: rgba(255, 255, 255, 0.87);
+  background-color: #0f172a;
+}
+
+body {
+  margin: 0;
+  display: flex;
+  place-items: center;
+  min-width: 320px;
+  min-height: 100vh;
+}
+
+#root {
+  width: 100%;
+  max-width: 960px;
+  margin: 0 auto;
+  padding: 2rem;
+  text-align: center;
+}
+`;
+    fs.writeFileSync(path.join(srcDir, 'index.css'), indexCss);
+    // 7. src/App.css
+    const appCss = `.container {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 2rem;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  background: rgba(30, 41, 59, 0.8);
+  border: 1px solid rgba(148, 163, 184, 0.2);
+  padding: 0.35rem 1rem;
+  border-radius: 9999px;
+  font-size: 0.875rem;
+  color: #38bdf8;
+}
+
+.title {
+  font-size: 2.75rem;
+  font-weight: 800;
+  margin: 0;
+  background: linear-gradient(135deg, #f8fafc 0%, #94a3b8 100%);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+
+.subtitle {
+  font-size: 1.15rem;
+  color: #94a3b8;
+  margin: 0;
+  max-width: 600px;
+}
+
+.lang-picker {
+  display: inline-flex;
+  background: #1e293b;
+  padding: 0.25rem;
+  border-radius: 0.75rem;
+  border: 1px solid #334155;
+  gap: 0.25rem;
+}
+
+.lang-btn {
+  padding: 0.5rem 1.25rem;
+  border-radius: 0.5rem;
+  border: none;
+  background: transparent;
+  color: #94a3b8;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.lang-btn.active {
+  background: #3b82f6;
+  color: #ffffff;
+}
+
+.card-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+  gap: 1.5rem;
+  width: 100%;
+}
+
+.card {
+  background: #1e293b;
+  border: 1px solid #334155;
+  border-radius: 1rem;
+  padding: 1.75rem;
+  text-align: left;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+}
+
+.card h3 {
+  margin-top: 0;
+  margin-bottom: 0.5rem;
+  color: #f8fafc;
+}
+
+.card p {
+  color: #94a3b8;
+  font-size: 0.95rem;
+  line-height: 1.6;
+}
+
+.btn-action {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  background: #2563eb;
+  color: #ffffff;
+  padding: 0.75rem 1.25rem;
+  border-radius: 0.5rem;
+  text-decoration: none;
+  font-weight: 600;
+  border: none;
+  cursor: pointer;
+  margin-top: 1rem;
+  transition: background 0.2s;
+}
+
+.btn-action:hover {
+  background: #1d4ed8;
+}
+
+.btn-outline {
+  background: transparent;
+  border: 1px solid #475569;
+  color: #f8fafc;
+}
+
+.btn-outline:hover {
+  background: #334155;
+}
+`;
+    fs.writeFileSync(path.join(srcDir, 'App.css'), appCss);
+    // 8. src/main.tsx
+    const mainTsx = `import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+import './index.css';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+`;
+    fs.writeFileSync(path.join(srcDir, 'main.tsx'), mainTsx);
+    // 9. src/App.tsx
+    const appTsx = `import { useState } from 'react';
+import { useTranslation, SupportedLanguage } from './locales/i18n';
+import './App.css';
+
+export default function App() {
+  const { t, language, setLanguage, languages } = useTranslation();
+  const [count, setCount] = useState(0);
+
+  return (
+    <div className="container">
+      <div className="badge">
+        <span>⚡</span>
+        <span>JSON Link Local-First Platform</span>
+      </div>
+
+      <h1 className="title">{t('app.title')}</h1>
+      <p className="subtitle">{t('app.subtitle')}</p>
+
+      {/* Language Switcher */}
+      <div className="lang-picker">
+        {languages.map((lang: SupportedLanguage) => (
+          <button
+            key={lang}
+            className={\`lang-btn \${language === lang ? 'active' : ''}\`}
+            onClick={() => setLanguage(lang)}
+          >
+            {lang === 'en' ? 'English' : 'မြန်မာ'}
+          </button>
+        ))}
+      </div>
+
+      <div className="card-grid">
+        {/* Interactive Demo Card */}
+        <div className="card">
+          <div>
+            <h3>{t('counter.label')}</h3>
+            <p>{t('auth.welcome', { username: 'Developer' })}</p>
+            <p>{t('counter.clicks', { count })}</p>
+          </div>
+          <button className="btn-action btn-outline" onClick={() => setCount((c) => c + 1)}>
+            {t('counter.button')}
+          </button>
+        </div>
+
+        {/* Devtool Dashboard Card */}
+        <div className="card">
+          <div>
+            <h3>{t('dashboard.card.title')}</h3>
+            <p>{t('dashboard.card.desc')}</p>
+          </div>
+          <a
+            href="/__jsonlink"
+            target="_blank"
+            rel="noopener noreferrer"
+            className="btn-action"
+          >
+            {t('dashboard.card.button')} ↗
+          </a>
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+    fs.writeFileSync(path.join(srcDir, 'App.tsx'), appTsx);
+    // 10. src/locales/
+    const localesDir = path.join(srcDir, 'locales');
+    fs.mkdirSync(localesDir, { recursive: true });
+    const enJson = {
+        "app.title": "JSON Link Starter",
+        "app.subtitle": "Instant local-first localization for modern React applications with Vite HMR.",
+        "auth.welcome": "Welcome back, {username}!",
+        "counter.label": "Reactive Localization Demo",
+        "counter.clicks": "You have clicked {count} times.",
+        "counter.button": "Increment Counter",
+        "dashboard.card.title": "Live Translation Workspace",
+        "dashboard.card.desc": "Inspect, edit, and organize all your translation keys side-by-side with two-way disk synchronization.",
+        "dashboard.card.button": "Open Dev Dashboard",
+        "common.switch_language": "Language",
+        "common.english": "English",
+        "common.myanmar": "မြန်မာ"
+    };
+    fs.writeFileSync(path.join(localesDir, 'en.json'), JSON.stringify(enJson, null, 2) + '\n');
+    const myJson = {
+        "app.title": "JSON Link စတင်အသုံးပြုခြင်း",
+        "app.subtitle": "React အက်ပ်များအတွက် Vite HMR ဖြင့် ချက်ချင်းချိတ်ဆက်အလုပ်လုပ်သော ဘာသာစကားစုံသုံး စနစ်။",
+        "auth.welcome": "ကြိုဆိုပါတယ် {username}!",
+        "counter.label": "အပြန်အလှန်တုံ့ပြန်နိုင်သော ကောင်တာ",
+        "counter.clicks": "သင် {count} ကြိမ် နှိပ်ခဲ့ပြီးပါပြီ။",
+        "counter.button": "ကောင်တာ တိုးမည်",
+        "dashboard.card.title": "တိုက်ရိုက် ဘာသာပြန် ဒက်ရှ်ဘုတ်",
+        "dashboard.card.desc": "စာသားများကို စာရင်းဇယားအတိုင်း ယှဉ်တွဲပြင်ဆင်ပြီး Disk ပေါ်သို့ တိုက်ရိုက်သိမ်းဆည်းနိုင်ပါသည်။",
+        "dashboard.card.button": "ဒက်ရှ်ဘုတ် ဖွင့်မည်",
+        "common.switch_language": "ဘာသာစကား",
+        "common.english": "English",
+        "common.myanmar": "မြန်မာ"
+    };
+    fs.writeFileSync(path.join(localesDir, 'my.json'), JSON.stringify(myJson, null, 2) + '\n');
+    const defaultKeys = Object.keys(enJson);
+    const translationsDts = `export type SupportedLanguage = "en" | "my";
+
+export type TranslationKey =
+${defaultKeys.map(k => `  | ${JSON.stringify(k)}`).join('\n')};
+
+export interface TranslationDictionary {
+  [key: string]: string;
+}
+`;
+    fs.writeFileSync(path.join(localesDir, 'translations.d.ts'), translationsDts);
+    const i18nTs = `import { useSyncExternalStore } from 'react';
+import type { SupportedLanguage, TranslationKey } from './translations';
+import en from './en.json';
+import my from './my.json';
+
+export const SUPPORTED_LANGUAGES: SupportedLanguage[] = ['en', 'my'];
+
+export const resources: Record<SupportedLanguage, Record<string, any>> = {
+  'en': en,
+  'my': my,
+};
+
+let currentLanguage: SupportedLanguage = 'en';
+const listeners = new Set<() => void>();
+
+function notify() {
+  listeners.forEach((listener) => listener());
+}
+
+export function setLanguage(lang: SupportedLanguage): void {
+  if (resources[lang]) {
+    currentLanguage = lang;
+    notify();
+  }
+}
+
+export function getLanguage(): SupportedLanguage {
+  return currentLanguage;
+}
+
+function resolveValue(obj: Record<string, any>, key: string): string | undefined {
+  if (!obj) return undefined;
+  if (obj[key] !== undefined) return String(obj[key]);
+  const parts = key.split('.');
+  let current: any = obj;
+  for (const part of parts) {
+    if (current && typeof current === 'object' && part in current) {
+      current = current[part];
+    } else {
+      return undefined;
+    }
+  }
+  return typeof current === 'string' ? current : undefined;
+}
+
+export function t(
+  key: TranslationKey | (string & {}),
+  params?: Record<string, string | number>,
+  lang?: SupportedLanguage
+): string {
+  const activeLang = lang || currentLanguage;
+  const dict = resources[activeLang] || resources['en'] || {};
+  let text = resolveValue(dict, key);
+
+  if (text === undefined) {
+    text = resolveValue(resources['en'] || {}, key) ?? key;
+  }
+
+  if (params && typeof text === 'string') {
+    return text.replace(/\\{([a-zA-Z0-9_]+)\\}/g, (_, varName) => {
+      return params[varName] !== undefined ? String(params[varName]) : \`{\${varName}}\`;
+    });
+  }
+
+  return text;
+}
+
+export function useTranslation() {
+  const lang = useSyncExternalStore(
+    (callback) => {
+      listeners.add(callback);
+      return () => listeners.delete(callback);
+    },
+    () => currentLanguage
+  );
+
+  return {
+    t,
+    language: lang,
+    setLanguage,
+    languages: SUPPORTED_LANGUAGES,
+  };
+}
+
+if (import.meta.hot) {
+  import.meta.hot.accept((newModule) => {
+    if (newModule) notify();
+  });
+}
+`;
+    fs.writeFileSync(path.join(localesDir, 'i18n.ts'), i18nTs);
+    // 11. .gitignore
+    const gitignore = `# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+`;
+    fs.writeFileSync(path.join(targetDir, '.gitignore'), gitignore);
+    // 12. README.md
+    const readme = `# ${projectName}
+
+A modern React + Vite application preconfigured with **[JSON Link](https://json-link.pages.dev)**.
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start local development server
+npm run dev
+\`\`\`
+
+- App is running at: **\`http://localhost:5173\`**
+- JSON Link Live Dashboard: **\`http://localhost:5173/__jsonlink\`**
+
+## Two-Way Disk Synchronization
+
+Changes made in the \`/__jsonlink\` web devtool are written directly to \`src/locales/*.json\` on disk with instant Vite HMR.
+`;
+    fs.writeFileSync(path.join(targetDir, 'README.md'), readme);
+    return { success: true };
+}
+//# sourceMappingURL=scaffoldStarter.js.map

package/dist/scaffoldStarter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffoldStarter.js","sourceRoot":"","sources":["../src/scaffoldStarter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "create-jsonlink",
+  "version": "1.0.0",
+  "description": "Scaffold a modern React + Vite application preconfigured with JSON Link localization workspace, or initialize JSON Link in an existing project",
+  "author": "Pyae Phyo Maung",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-jsonlink": "./bin/create-jsonlink.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyaephyomaungdev/json-link.git",
+    "directory": "packages/create-jsonlink"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "create-jsonlink",
+    "jsonlink",
+    "json-link",
+    "i18n",
+    "vite",
+    "vite-plugin",
+    "react",
+    "localization",
+    "translation",
+    "starter",
+    "scaffold",
+    "myanmar"
+  ]
+}