create-du-app 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# @company-starter/cli (`create-app`)
+
+CLI generator: hỏi tên project + chọn template (Mobile / Frontend / Backend) → sinh ra
+một monorepo sản phẩm độc lập.
+
+## Chạy
+
+```bash
+cd packages/cli
+pnpm install
+pnpm link --global   # đăng ký lệnh global `create-app`
+create-app           # hoặc: node src/index.js
+```
+
+## Source
+
+| File          | Vai trò |
+|---------------|---------|
+| `index.js`    | entry point, parse args (`--help`, `--version`), gọi prompt rồi generate |
+| `registry.js` | **khai báo dạng data**: các nhóm + tech + `templatePath` + `lang`. Thêm/bớt template chỉ sửa file này |
+| `prompts.js`  | logic hỏi tương tác (`@clack/prompts`): tên project → multiselect nhóm → select tech mỗi nhóm |
+| `generate.js` | copy template, rename `_package.json`→`package.json`, sinh `package.json` + `pnpm-workspace.yaml` gốc động, tạo `packages/shared` có điều kiện, thay `{{PROJECT_NAME}}` |
+
+## Quy ước template
+
+- File đặt tên `_package.json` → generate thành `package.json`. Tương tự `_gitignore` → `.gitignore`, `_npmrc` → `.npmrc`.
+- Mọi file text chứa `{{PROJECT_NAME}}` sẽ được thay bằng tên project thật.
+- `packages/shared` chỉ được tạo khi có **>= 2** lựa chọn `lang === 'js'`.

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "create-du-app",
+  "version": "0.1.0",
+  "description": "CLI generator: chọn template (Mobile/FE/BE) và sinh ra monorepo sản phẩm",
+  "type": "module",
+  "bin": {
+    "create-app": "src/index.js"
+  },
+  "files": [
+    "src",
+    "templates"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "prepack": "node scripts/bundle-templates.mjs",
+    "postpack": "node scripts/bundle-templates.mjs --clean"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@9.0.0",
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "fs-extra": "^11.2.0"
+  }
+}

package/src/generate.js

@@ -0,0 +1,133 @@
+// generate.js — copy template + rename + sinh package.json động + replace placeholder.
+//
+// Đầu vào: plan từ prompts.js → { projectName, selections: [{group, option}] }
+// và `repoRoot` (root của company-starter, nơi chứa templates/).
+
+import path from 'node:path';
+import fse from 'fs-extra';
+import {
+  SHARED_TEMPLATE_PATH,
+  SHARED_OUTPUT_DIR,
+} from './registry.js';
+
+const PLACEHOLDER = /\{\{PROJECT_NAME\}\}/g;
+
+// File trong template được đặt tên "an toàn" để npm/tooling repo gốc không quét nhầm.
+// Khi generate ra sản phẩm thật thì rename lại tên chuẩn.
+const RENAME_MAP = {
+  '_package.json': 'package.json',
+  '_gitignore': '.gitignore',
+  '_npmrc': '.npmrc',
+};
+
+// Phần mở rộng được coi là "text" → sẽ thay {{PROJECT_NAME}}.
+const TEXT_EXT = new Set([
+  '.json', '.js', '.jsx', '.ts', '.tsx', '.md', '.txt', '.yml', '.yaml',
+  '.env', '.html', '.css', '.scss', '.gitignore', '.npmrc', '.dart', '.php',
+]);
+
+function isTextFile(filePath) {
+  const base = path.basename(filePath);
+  if (base === '.gitignore' || base === '.npmrc' || base === '.env') return true;
+  return TEXT_EXT.has(path.extname(filePath).toLowerCase());
+}
+
+function renameBasename(name) {
+  return RENAME_MAP[name] ?? name;
+}
+
+// Copy 1 template folder → đích, vừa rename file vừa replace {{PROJECT_NAME}}.
+async function copyTemplate(srcDir, destDir, projectName) {
+  // Template rỗng (chưa bỏ source thật vào) vẫn phải chạy được.
+  if (!(await fse.pathExists(srcDir))) {
+    throw new Error(`Không tìm thấy template: ${srcDir}`);
+  }
+
+  await fse.ensureDir(destDir);
+
+  const entries = await fse.readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyTemplate(srcPath, path.join(destDir, entry.name), projectName);
+      continue;
+    }
+
+    const destName = renameBasename(entry.name);
+    const destPath = path.join(destDir, destName);
+
+    if (isTextFile(destPath)) {
+      const raw = await fse.readFile(srcPath, 'utf8');
+      await fse.writeFile(destPath, raw.replace(PLACEHOLDER, projectName));
+    } else {
+      await fse.copy(srcPath, destPath);
+    }
+  }
+}
+
+// Sinh package.json gốc của project động (pnpm: KHÔNG có field "workspaces").
+function buildRootPackageJson(projectName) {
+  return {
+    name: projectName,
+    version: '0.1.0',
+    private: true,
+    engines: { node: '>=18' },
+    packageManager: 'pnpm@9.0.0',
+  };
+}
+
+// Sinh nội dung pnpm-workspace.yaml.
+// packages: chỉ các apps/* thực sự tạo + luôn có packages/*.
+function buildPnpmWorkspaceYaml(createdAppDirs) {
+  const entries = [...createdAppDirs, 'packages/*'];
+  const lines = entries.map((p) => `  - '${p}'`);
+  return `packages:\n${lines.join('\n')}\n`;
+}
+
+export async function generate(plan, repoRoot, cwd = process.cwd()) {
+  const { projectName, selections } = plan;
+  const projectRoot = path.resolve(cwd, projectName);
+  const logs = [];
+
+  if (await fse.pathExists(projectRoot)) {
+    throw new Error(`Thư mục "${projectName}" đã tồn tại tại ${projectRoot}.`);
+  }
+
+  await fse.ensureDir(projectRoot);
+
+  // 1) Copy từng app đã chọn.
+  const createdAppDirs = [];
+  for (const { group, option } of selections) {
+    const srcDir = path.resolve(repoRoot, option.templatePath);
+    const destDir = path.resolve(projectRoot, group.outputDir);
+    await copyTemplate(srcDir, destDir, projectName);
+    createdAppDirs.push(group.outputDir);
+    logs.push(`✓ ${group.label} (${option.label}) → ${group.outputDir}`);
+  }
+
+  // 2) packages/shared CÓ ĐIỀU KIỆN: >= 2 lựa chọn lang === 'js'.
+  const jsCount = selections.filter((s) => s.option.lang === 'js').length;
+  if (jsCount >= 2) {
+    const srcDir = path.resolve(repoRoot, SHARED_TEMPLATE_PATH);
+    const destDir = path.resolve(projectRoot, SHARED_OUTPUT_DIR);
+    await copyTemplate(srcDir, destDir, projectName);
+    logs.push(`✓ shared → ${SHARED_OUTPUT_DIR} (có ${jsCount} app JS/TS)`);
+  } else {
+    logs.push(`• Bỏ qua shared vì không đủ app JS/TS (cần >= 2, hiện có ${jsCount}).`);
+  }
+
+  // 3) Sinh package.json gốc + pnpm-workspace.yaml động.
+  const rootPkg = buildRootPackageJson(projectName);
+  await fse.writeJson(path.join(projectRoot, 'package.json'), rootPkg, { spaces: 2 });
+  logs.push('✓ package.json');
+
+  const wsEntries = [...createdAppDirs, 'packages/*'];
+  await fse.writeFile(
+    path.join(projectRoot, 'pnpm-workspace.yaml'),
+    buildPnpmWorkspaceYaml(createdAppDirs),
+  );
+  logs.push(`✓ pnpm-workspace.yaml (packages: ${wsEntries.join(', ')})`);
+
+  return { projectRoot, logs };
+}

package/src/index.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+// index.js — entry point. Parse args + chạy prompt (TTY) hoặc generate trực tiếp (flags).
+//
+// Cách chạy:
+//   create-app                                 chạy tương tác (cần terminal thật)
+//   create-app --name my-shop --be nestjs      non-interactive (chạy mọi nơi)
+//   node src/index.js
+//
+// Flags:
+//   -h, --help              in trợ giúp
+//   -v, --version           in version
+//   -n, --name <name>       tên project (non-interactive)
+//   --mobile <id>           rn | expo | flutter
+//   --fe <id>               nextjs | reactjs
+//   --be <id>               nodejs | nestjs | php
+//   -y, --yes               không hỏi, generate luôn (cần --name + >=1 nhóm)
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fse from 'fs-extra';
+import { runPrompts, outro } from './prompts.js';
+import { generate } from './generate.js';
+import { GROUPS, findOption } from './registry.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Tìm thư mục gốc chứa templates/. Hỗ trợ 2 kịch bản:
+//   1) Chạy từ repo (clone): templates ở ../../../templates (root company-starter)
+//   2) Cài qua npm (đã publish): templates được đóng gói NGAY TRONG package CLI,
+//      ở packages/cli/templates → ../templates
+// Chọn nơi nào thực sự tồn tại folder templates/.
+function resolveTemplatesRoot() {
+  const candidates = [
+    path.resolve(__dirname, '..'),              // npm publish: cli/templates
+    path.resolve(__dirname, '..', '..', '..'),  // repo: root/templates
+  ];
+  for (const root of candidates) {
+    if (fse.pathExistsSync(path.join(root, 'templates'))) return root;
+  }
+  // fallback: repo root (để thông báo lỗi của generate.js đủ rõ)
+  return path.resolve(__dirname, '..', '..', '..');
+}
+const REPO_ROOT = resolveTemplatesRoot();
+
+// map flag → groupId (để gợi ý lỗi cho gọn)
+const GROUP_FLAGS = { mobile: 'mobile', fe: 'fe', be: 'be' };
+
+async function readVersion() {
+  try {
+    const pkg = await fse.readJson(path.resolve(__dirname, '..', 'package.json'));
+    return pkg.version ?? '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function printHelp() {
+  console.log(`
+create-app — sinh monorepo sản phẩm từ template công ty
+
+Cách dùng:
+  create-app                                chạy tương tác (cần terminal thật)
+  create-app --name my-shop --be nestjs     non-interactive (chạy mọi nơi)
+  node src/index.js                         tương đương (khi chưa link)
+
+Tuỳ chọn:
+  -h, --help              in trợ giúp này
+  -v, --version           in version
+  -n, --name <name>       tên project
+  --mobile <id>           rn | expo | flutter
+  --fe <id>               nextjs | reactjs
+  --be <id>               nodejs | nestjs | php
+  -y, --yes               generate luôn không hỏi (cần --name + >=1 nhóm)
+
+Ví dụ:
+  create-app --name my-shop --mobile expo --fe nextjs --be nestjs
+
+Thêm/bớt template: sửa packages/cli/src/registry.js
+`);
+}
+
+// Parse argv kiểu "--key value" / "-k value" + cờ boolean.
+function parseArgs(argv) {
+  const out = { _flags: new Set() };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    switch (a) {
+      case '-h': case '--help': out._flags.add('help'); break;
+      case '-v': case '--version': out._flags.add('version'); break;
+      case '-y': case '--yes': out._flags.add('yes'); break;
+      case '-n': case '--name': out.name = argv[++i]; break;
+      case '--mobile': out.mobile = argv[++i]; break;
+      case '--fe': out.fe = argv[++i]; break;
+      case '--be': out.be = argv[++i]; break;
+      default:
+        throw new Error(`Tham số không hợp lệ: ${a}. Xem: create-app --help`);
+    }
+  }
+  return out;
+}
+
+// Có bất kỳ flag chọn template nào không → đi đường non-interactive.
+function hasSelectionFlags(args) {
+  return Boolean(args.name || args.mobile || args.fe || args.be || args._flags.has('yes'));
+}
+
+// Dựng plan từ flags, validate từng id theo registry.
+function planFromFlags(args) {
+  const name = (args.name ?? '').trim();
+  if (!name) {
+    throw new Error('Thiếu --name <tên-project>.');
+  }
+  if (!/^[a-z0-9][a-z0-9-_]*$/i.test(name)) {
+    throw new Error('Tên project chỉ gồm chữ/số/-/_ và bắt đầu bằng chữ/số.');
+  }
+
+  const selections = [];
+  for (const [flag, groupId] of Object.entries(GROUP_FLAGS)) {
+    const optionId = args[flag];
+    if (!optionId) continue;
+    const found = findOption(groupId, optionId);
+    if (!found) {
+      const valid = GROUPS.find((g) => g.id === groupId).options.map((o) => o.id).join(', ');
+      throw new Error(`--${flag} "${optionId}" không hợp lệ. Hợp lệ: ${valid}.`);
+    }
+    selections.push(found);
+  }
+
+  if (selections.length === 0) {
+    throw new Error('Cần ít nhất 1 nhóm: --mobile / --fe / --be.');
+  }
+  return { projectName: name, selections };
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args._flags.has('help')) {
+    printHelp();
+    return;
+  }
+  if (args._flags.has('version')) {
+    console.log(await readVersion());
+    return;
+  }
+
+  // Quyết định luồng:
+  //  - có flag chọn template → non-interactive
+  //  - không có flag NHƯNG stdin không phải TTY → báo lỗi rõ ràng thay vì treo
+  //  - còn lại → tương tác
+  let plan;
+  if (hasSelectionFlags(args)) {
+    plan = planFromFlags(args);
+  } else if (!process.stdin.isTTY) {
+    throw new Error(
+      'Terminal hiện tại không hỗ trợ chế độ tương tác (stdin không phải TTY).\n' +
+      '  → Chạy trong Terminal.app/iTerm, HOẶC dùng flags:\n' +
+      '    create-app --name my-shop --mobile expo --fe nextjs --be nestjs',
+    );
+  } else {
+    plan = await runPrompts();
+  }
+
+  const { projectRoot, logs } = await generate(plan, REPO_ROOT);
+
+  console.log('');
+  for (const line of logs) console.log('  ' + line);
+  console.log('');
+
+  const rel = path.relative(process.cwd(), projectRoot) || projectRoot;
+  const msg = `Xong! Tiếp theo:\n\n  cd ${rel} && pnpm install\n`;
+  // outro() (clack) chỉ đẹp trong TTY; non-interactive thì in thường.
+  if (process.stdout.isTTY && !hasSelectionFlags(args)) outro(msg);
+  else console.log(msg);
+}
+
+main().catch((err) => {
+  console.error('\n✗ Lỗi:', err.message);
+  process.exit(1);
+});

package/src/prompts.js

@@ -0,0 +1,74 @@
+// prompts.js — logic hỏi tương tác.
+//
+// Trả về một "plan" thuần data để generate.js thực thi:
+//   { projectName, selections: [{ group, option }, ...] }
+// Không làm I/O ra ổ đĩa ở đây — chỉ hỏi và validate.
+
+import {
+  intro,
+  outro,
+  text,
+  multiselect,
+  select,
+  isCancel,
+  cancel,
+} from '@clack/prompts';
+import { GROUPS, findOption } from './registry.js';
+
+function ensureNotCancelled(value) {
+  if (isCancel(value)) {
+    cancel('Đã huỷ. Không có gì được tạo.');
+    process.exit(0);
+  }
+  return value;
+}
+
+export async function runPrompts() {
+  intro('create-app — sinh monorepo sản phẩm từ template công ty');
+
+  // 1) Tên project
+  const projectName = ensureNotCancelled(
+    await text({
+      message: 'Tên project?',
+      placeholder: 'my-shop',
+      validate(value) {
+        const v = (value ?? '').trim();
+        if (!v) return 'Tên project không được để trống.';
+        if (!/^[a-z0-9][a-z0-9-_]*$/i.test(v)) {
+          return 'Chỉ dùng chữ, số, "-" hoặc "_" và bắt đầu bằng chữ/số.';
+        }
+        return undefined;
+      },
+    }),
+  );
+
+  // 2) Multi-select các nhóm cần (chọn được nhiều)
+  const groupIds = ensureNotCancelled(
+    await multiselect({
+      message: 'Chọn các nhóm cần (Space để chọn, Enter để xác nhận):',
+      options: GROUPS.map((g) => ({ value: g.id, label: g.label })),
+      required: true,
+    }),
+  );
+
+  // 3) Với mỗi nhóm đã chọn → single-select 1 công nghệ
+  const selections = [];
+  for (const groupId of groupIds) {
+    const group = GROUPS.find((g) => g.id === groupId);
+    const optionId = ensureNotCancelled(
+      await select({
+        message: `${group.label}: chọn 1 công nghệ`,
+        options: group.options.map((o) => ({ value: o.id, label: o.label })),
+      }),
+    );
+    const found = findOption(groupId, optionId);
+    selections.push(found); // { group, option }
+  }
+
+  return {
+    projectName: projectName.trim(),
+    selections,
+  };
+}
+
+export { outro };

package/src/registry.js

@@ -0,0 +1,57 @@
+// registry.js — KHAI BÁO các nhóm + tech + đường dẫn template.
+//
+// Đây là nguồn dữ liệu duy nhất để thêm/bớt template. Muốn thêm một công nghệ mới
+// chỉ cần thêm một object vào `options` của nhóm tương ứng (hoặc thêm hẳn một nhóm).
+// KHÔNG cần đụng tới logic ở prompts.js / generate.js.
+//
+// Mỗi option:
+//   id           : định danh ngắn (dùng nội bộ)
+//   label        : nhãn hiển thị khi hỏi
+//   templatePath : đường dẫn template, TÍNH TỪ ROOT của repo company-starter này
+//   lang         : 'js' | 'dart' | 'php' ...
+//                  Chỉ option có lang === 'js' mới đủ điều kiện dùng packages/shared.
+
+export const GROUPS = [
+  {
+    id: 'mobile',
+    label: 'Mobile',
+    outputDir: 'apps/mobile',
+    options: [
+      { id: 'rn',      label: 'React Native', templatePath: 'templates/mobile/rn',      lang: 'js' },
+      { id: 'expo',    label: 'Expo',         templatePath: 'templates/mobile/expo',    lang: 'js' },
+      { id: 'flutter', label: 'Flutter',      templatePath: 'templates/mobile/flutter', lang: 'dart' },
+    ],
+  },
+  {
+    id: 'fe',
+    label: 'Frontend',
+    outputDir: 'apps/web',
+    options: [
+      { id: 'nextjs',  label: 'Next.js',  templatePath: 'templates/fe/nextjs',  lang: 'js' },
+      { id: 'reactjs', label: 'ReactJS',  templatePath: 'templates/fe/reactjs', lang: 'js' },
+    ],
+  },
+  {
+    id: 'be',
+    label: 'Backend',
+    outputDir: 'apps/backend',
+    options: [
+      { id: 'nodejs', label: 'Node.js', templatePath: 'templates/be/nodejs', lang: 'js' },
+      { id: 'nestjs', label: 'NestJS',  templatePath: 'templates/be/nestjs', lang: 'js' },
+      { id: 'php',    label: 'PHP',     templatePath: 'templates/be/php',     lang: 'php' },
+    ],
+  },
+];
+
+// path tới folder template dùng chung (chỉ copy khi >= 2 lựa chọn lang === 'js')
+export const SHARED_TEMPLATE_PATH = 'templates/shared';
+export const SHARED_OUTPUT_DIR = 'packages/shared';
+
+// Tra cứu nhanh 1 option theo (groupId, optionId).
+export function findOption(groupId, optionId) {
+  const group = GROUPS.find((g) => g.id === groupId);
+  if (!group) return null;
+  const option = group.options.find((o) => o.id === optionId);
+  if (!option) return null;
+  return { group, option };
+}

package/templates/be/nestjs/README.md

@@ -0,0 +1,11 @@
+# Placeholder: NestJS (be/nestjs)
+
+Đây là **placeholder** cho template **NestJS**.
+
+Bỏ source chuẩn của NestJS vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/be/nestjs/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-backend",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder NestJS backend cho {{PROJECT_NAME}}"
+}

package/templates/be/nodejs/README.md

@@ -0,0 +1,11 @@
+# Placeholder: Node.js (be/nodejs)
+
+Đây là **placeholder** cho template **Node.js**.
+
+Bỏ source chuẩn của Node.js backend vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/be/nodejs/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-backend",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder Node.js backend cho {{PROJECT_NAME}}"
+}

package/templates/be/php/README.md

@@ -0,0 +1,15 @@
+# Placeholder: PHP (be/php)
+
+Đây là **placeholder** cho template **PHP**.
+
+Bỏ source chuẩn của PHP backend vào đây.
+
+> **Lưu ý riêng cho PHP (`lang: php`):**
+> - **Không** có `_package.json` (PHP dùng `composer.json`, không phải npm).
+> - **Không** nằm trong npm workspaces của project.
+> - **Không** dùng `packages/shared` (shared chỉ dành cho hệ JS/TS).
+>
+> Khi generate, CLI vẫn copy nguyên folder này vào `apps/backend` và thay `{{PROJECT_NAME}}`
+> trong các file text (vd `composer.json`, `README.md`).
+
+Bạn có thể đặt `{{PROJECT_NAME}}` trong `composer.json` để CLI tự điền tên project.

package/templates/fe/nextjs/README.md

@@ -0,0 +1,11 @@
+# Placeholder: Next.js (fe/nextjs)
+
+Đây là **placeholder** cho template **Next.js**.
+
+Bỏ source chuẩn của Next.js vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/fe/nextjs/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-web",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder Next.js app cho {{PROJECT_NAME}}"
+}

package/templates/fe/reactjs/README.md

@@ -0,0 +1,11 @@
+# Placeholder: ReactJS (fe/reactjs)
+
+Đây là **placeholder** cho template **ReactJS**.
+
+Bỏ source chuẩn của ReactJS vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/fe/reactjs/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-web",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder ReactJS app cho {{PROJECT_NAME}}"
+}

package/templates/mobile/expo/README.md

@@ -0,0 +1,11 @@
+# Placeholder: Expo (mobile/expo)
+
+Đây là **placeholder** cho template **Expo**.
+
+Bỏ source chuẩn của Expo vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/mobile/expo/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-mobile",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder Expo app cho {{PROJECT_NAME}}"
+}

package/templates/mobile/flutter/README.md

@@ -0,0 +1,15 @@
+# Placeholder: Flutter (mobile/flutter)
+
+Đây là **placeholder** cho template **Flutter**.
+
+Bỏ source chuẩn của Flutter (Dart) vào đây.
+
+> **Lưu ý riêng cho Flutter (`lang: dart`):**
+> - **Không** có `_package.json` (Flutter dùng `pubspec.yaml`, không phải npm).
+> - **Không** nằm trong npm workspaces của project.
+> - **Không** dùng `packages/shared` (shared chỉ dành cho hệ JS/TS).
+>
+> Khi generate, CLI vẫn copy nguyên folder này vào `apps/mobile` và thay `{{PROJECT_NAME}}`
+> trong các file text (vd `pubspec.yaml`, `README.md`).
+
+Bạn có thể đặt `{{PROJECT_NAME}}` trong `pubspec.yaml` để CLI tự điền tên project.

package/templates/mobile/rn/README.md

@@ -0,0 +1,11 @@
+# Placeholder: React Native (mobile/rn)
+
+Đây là **placeholder** cho template **React Native**.
+
+Bỏ source chuẩn của React Native vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Đặt `.gitignore` thành **`_gitignore`**, `.npmrc` thành **`_npmrc`** nếu có.
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.

package/templates/mobile/rn/_package.json

@@ -0,0 +1,6 @@
+{
+  "name": "{{PROJECT_NAME}}-mobile",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Placeholder React Native app cho {{PROJECT_NAME}}"
+}

package/templates/shared/README.md

@@ -0,0 +1,11 @@
+# Placeholder: shared (packages/shared)
+
+Đây là **placeholder** cho package dùng chung của hệ **JS/TS**: types + api client.
+
+Bỏ source chuẩn (types, api client...) dùng chung cho các app JS/TS vào đây. Lưu ý quy ước:
+
+- Đặt `package.json` của template thành **`_package.json`** (CLI sẽ tự rename lại khi generate).
+- Bất kỳ chỗ nào cần tên project, ghi `{{PROJECT_NAME}}` — CLI sẽ thay bằng tên thật.
+
+> Package này **chỉ được tạo** khi project có **>= 2** lựa chọn `lang === 'js'`.
+> Nếu ít hơn, CLI sẽ bỏ qua và in thông báo.

package/templates/shared/_package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@{{PROJECT_NAME}}/shared",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Types + api client dùng chung cho {{PROJECT_NAME}}",
+  "main": "index.js",
+  "type": "module"
+}

package/templates/shared/index.js

@@ -0,0 +1,4 @@
+// Package dùng chung cho {{PROJECT_NAME}}.
+// Placeholder — bỏ types + api client thật vào đây.
+
+export const PROJECT_NAME = '{{PROJECT_NAME}}';