create-du-app 0.1.0 → 0.1.1

package/README.md

@@ -1,28 +1,64 @@
-# @company-starter/cli (`create-app`)
+# create-du-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.
+> The `create-app` CLI — scaffolds a standalone product monorepo from company templates.
 
-## Chạy
+Prompts for a project name and a selection of stacks (Mobile / Frontend / Backend), then copies
+the matching templates, renames manifests, substitutes the project name, and emits a ready-to-run
+pnpm workspace.
+
+## Installation
 
 ```bash
 cd packages/cli
 pnpm install
-pnpm link --global   # đăng ký lệnh global `create-app`
-create-app           # hoặc: node src/index.js
+pnpm link --global   # registers the global `create-app` command
+```
+
+Or run without linking:
+
+```bash
+node src/index.js
 ```
 
-## Source
+## Usage
+
+**Interactive** (requires a real terminal):
+
+```bash
+create-app
+```
+
+**Non-interactive** (CI or any terminal):
+
+```bash
+create-app --name my-shop --mobile expo --fe nextjs --be nestjs
+```
+
+### Options
+
+| Flag                 | Description                              |
+|----------------------|------------------------------------------|
+| `-n`, `--name <name>`| Project name                             |
+| `--mobile <id>`      | `rn` · `expo` · `flutter`                |
+| `--fe <id>`          | `nextjs` · `reactjs`                     |
+| `--be <id>`          | `nodejs` · `nestjs` · `php`              |
+| `-h`, `--help`       | Print help                               |
+| `-v`, `--version`    | Print version                            |
+
+## How it works
+
+| File          | Responsibility |
+|---------------|----------------|
+| `index.js`    | Entry point. Parses flags, decides interactive vs. non-interactive, runs the generator. |
+| `registry.js` | **Data declaration** of groups, technologies, `templatePath`, and `lang`. The only file to edit when adding or removing a stack. |
+| `prompts.js`  | Interactive prompts (`@clack/prompts`): project name → multi-select groups → select one technology per group. |
+| `generate.js` | Copies templates, renames `_package.json` → `package.json`, generates the root `package.json` + `pnpm-workspace.yaml`, conditionally creates `packages/shared`, and substitutes `{{PROJECT_NAME}}`. |
 
-| 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}}` |
+## Template conventions
 
-## Quy ước template
+- A manifest named `_package.json` is renamed to `package.json` on generate. Likewise
+  `_gitignore` → `.gitignore` and `_npmrc` → `.npmrc`.
+- Any text file containing `{{PROJECT_NAME}}` has it replaced with the real project name.
+- `packages/shared` is created only when **≥ 2** selections have `lang === 'js'`.
 
-- 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'`.
+See **[CONTRIBUTING.md](../../CONTRIBUTING.md)** for the full workflow of adding real source.

package/package.json

@@ -1,7 +1,7 @@
 {
   "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",
+  "version": "0.1.1",
+  "description": "CLI generator: pick templates (Mobile/FE/BE) and scaffold a product monorepo",
   "type": "module",
   "bin": {
     "create-app": "src/index.js"

package/src/generate.js

@@ -1,7 +1,7 @@
-// generate.js — copy template + rename + sinh package.json động + replace placeholder.
+// generate.js — copy templates + rename + generate dynamic package.json + replace placeholders.
 //
-// Đầu vào: plan từ prompts.js → { projectName, selections: [{group, option}] }
-// và `repoRoot` (root của company-starter, nơi chứa templates/).
+// Input: the plan from prompts.js → { projectName, selections: [{group, option}] }
+// and `repoRoot` (the company-starter root that contains templates/).
 
 import path from 'node:path';
 import fse from 'fs-extra';
@@ -12,15 +12,15 @@ import {
 
 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.
+// Files inside a template are given "safe" names so the root repo's npm/tooling does not
+// pick them up by mistake. When generating the real product, they are renamed back.
 const RENAME_MAP = {
   '_package.json': 'package.json',
   '_gitignore': '.gitignore',
   '_npmrc': '.npmrc',
 };
 
-// Phần mở rộng được coi là "text" → sẽ thay {{PROJECT_NAME}}.
+// Extensions treated as "text" → {{PROJECT_NAME}} gets replaced.
 const TEXT_EXT = new Set([
   '.json', '.js', '.jsx', '.ts', '.tsx', '.md', '.txt', '.yml', '.yaml',
   '.env', '.html', '.css', '.scss', '.gitignore', '.npmrc', '.dart', '.php',
@@ -36,11 +36,11 @@ function renameBasename(name) {
   return RENAME_MAP[name] ?? name;
 }
 
-// Copy 1 template folder → đích, vừa rename file vừa replace {{PROJECT_NAME}}.
+// Copy one template folder → destination, renaming files and replacing {{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.
+  // An empty template (real source not dropped in yet) must still work.
   if (!(await fse.pathExists(srcDir))) {
-    throw new Error(`Không tìm thấy template: ${srcDir}`);
+    throw new Error(`Template not found: ${srcDir}`);
   }
 
   await fse.ensureDir(destDir);
@@ -66,7 +66,7 @@ async function copyTemplate(srcDir, destDir, projectName) {
   }
 }
 
-// Sinh package.json gốc của project động (pnpm: KHÔNG có field "workspaces").
+// Build the project's root package.json dynamically (pnpm: NO "workspaces" field).
 function buildRootPackageJson(projectName) {
   return {
     name: projectName,
@@ -77,8 +77,8 @@ function buildRootPackageJson(projectName) {
   };
 }
 
-// Sinh nội dung pnpm-workspace.yaml.
-// packages: chỉ các apps/* thực sự tạo + luôn có packages/*.
+// Build the contents of pnpm-workspace.yaml.
+// packages: only the apps/* actually created + always packages/*.
 function buildPnpmWorkspaceYaml(createdAppDirs) {
   const entries = [...createdAppDirs, 'packages/*'];
   const lines = entries.map((p) => `  - '${p}'`);
@@ -91,12 +91,12 @@ export async function generate(plan, repoRoot, cwd = process.cwd()) {
   const logs = [];
 
   if (await fse.pathExists(projectRoot)) {
-    throw new Error(`Thư mục "${projectName}" đã tồn tại tại ${projectRoot}.`);
+    throw new Error(`Directory "${projectName}" already exists at ${projectRoot}.`);
   }
 
   await fse.ensureDir(projectRoot);
 
-  // 1) Copy từng app đã chọn.
+  // 1) Copy each selected app.
   const createdAppDirs = [];
   for (const { group, option } of selections) {
     const srcDir = path.resolve(repoRoot, option.templatePath);
@@ -106,18 +106,18 @@ export async function generate(plan, repoRoot, cwd = process.cwd()) {
     logs.push(`✓ ${group.label} (${option.label}) → ${group.outputDir}`);
   }
 
-  // 2) packages/shared CÓ ĐIỀU KIỆN: >= 2 lựa chọn lang === 'js'.
+  // 2) packages/shared is CONDITIONAL: >= 2 selections with 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)`);
+    logs.push(`✓ shared → ${SHARED_OUTPUT_DIR} (${jsCount} JS/TS apps)`);
   } else {
-    logs.push(`• Bỏ qua shared vì không đủ app JS/TS (cần >= 2, hiện có ${jsCount}).`);
+    logs.push(`• Skipping shared: not enough JS/TS apps (need >= 2, have ${jsCount}).`);
   }
 
-  // 3) Sinh package.json gốc + pnpm-workspace.yaml động.
+  // 3) Generate the root package.json + pnpm-workspace.yaml dynamically.
   const rootPkg = buildRootPackageJson(projectName);
   await fse.writeJson(path.join(projectRoot, 'package.json'), rootPkg, { spaces: 2 });
   logs.push('✓ package.json');

package/src/index.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
-// index.js — entry point. Parse args + chạy prompt (TTY) hoặc generate trực tiếp (flags).
+// index.js — entry point. Parse args + run prompts (TTY) or generate directly (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)
+// Usage:
+//   create-app                                 interactive (requires a real terminal)
+//   create-app --name my-shop --be nestjs      non-interactive (runs anywhere)
 //   node src/index.js
 //
 // Flags:
-//   -h, --help              in trợ giúp
-//   -v, --version           in version
-//   -n, --name <name>       tên project (non-interactive)
+//   -h, --help              print help
+//   -v, --version           print version
+//   -n, --name <name>       project name (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)
+//   -y, --yes               generate without prompting (needs --name + >=1 group)
 
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -24,11 +24,11 @@ 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/.
+// Resolve the root folder that contains templates/. Supports 2 scenarios:
+//   1) Running from the repo (clone): templates at ../../../templates (company-starter root)
+//   2) Installed via npm (published): templates are bundled INSIDE the CLI package,
+//      at packages/cli/templates → ../templates
+// Pick whichever location actually has a templates/ folder.
 function resolveTemplatesRoot() {
   const candidates = [
     path.resolve(__dirname, '..'),              // npm publish: cli/templates
@@ -37,12 +37,12 @@ function resolveTemplatesRoot() {
   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õ)
+  // fallback: repo root (so generate.js can emit a clear error)
   return path.resolve(__dirname, '..', '..', '..');
 }
 const REPO_ROOT = resolveTemplatesRoot();
 
-// map flag → groupId (để gợi ý lỗi cho gọn)
+// Map flag → groupId (for concise error hints).
 const GROUP_FLAGS = { mobile: 'mobile', fe: 'fe', be: 'be' };
 
 async function readVersion() {
@@ -56,30 +56,30 @@ async function readVersion() {
 
 function printHelp() {
   console.log(`
-create-app — sinh monorepo sản phẩm từ template công ty
+create-app — scaffold a product monorepo from company templates
 
-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)
+Usage:
+  create-app                                interactive (requires a real terminal)
+  create-app --name my-shop --be nestjs     non-interactive (runs anywhere)
+  node src/index.js                         equivalent (when not linked)
 
-Tuỳ chọn:
-  -h, --help              in trợ giúp này
-  -v, --version           in version
-  -n, --name <name>       tên project
+Options:
+  -h, --help              print this help
+  -v, --version           print version
+  -n, --name <name>       project name
   --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)
+  -y, --yes               generate without prompting (needs --name + >=1 group)
 
-Ví dụ:
+Example:
   create-app --name my-shop --mobile expo --fe nextjs --be nestjs
 
-Thêm/bớt template: sửa packages/cli/src/registry.js
+Add/remove templates: edit packages/cli/src/registry.js
 `);
 }
 
-// Parse argv kiểu "--key value" / "-k value" + cờ boolean.
+// Parse argv as "--key value" / "-k value" + boolean flags.
 function parseArgs(argv) {
   const out = { _flags: new Set() };
   for (let i = 0; i < argv.length; i++) {
@@ -93,25 +93,25 @@ function parseArgs(argv) {
       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`);
+        throw new Error(`Invalid argument: ${a}. See: create-app --help`);
     }
   }
   return out;
 }
 
-// Có bất kỳ flag chọn template nào không → đi đường non-interactive.
+// Any template-selection flag present → go the non-interactive route.
 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.
+// Build a plan from flags, validating each id against the registry.
 function planFromFlags(args) {
   const name = (args.name ?? '').trim();
   if (!name) {
-    throw new Error('Thiếu --name <tên-project>.');
+    throw new Error('Missing --name <project-name>.');
   }
   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ố.');
+    throw new Error('Project name may only contain letters/numbers/-/_ and must start with a letter/number.');
   }
 
   const selections = [];
@@ -121,13 +121,13 @@ function planFromFlags(args) {
     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}.`);
+      throw new Error(`--${flag} "${optionId}" is invalid. Valid: ${valid}.`);
     }
     selections.push(found);
   }
 
   if (selections.length === 0) {
-    throw new Error('Cần ít nhất 1 nhóm: --mobile / --fe / --be.');
+    throw new Error('At least one group is required: --mobile / --fe / --be.');
   }
   return { projectName: name, selections };
 }
@@ -144,17 +144,17 @@ async function main() {
     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
+  // Decide the flow:
+  //  - selection flags present → non-interactive
+  //  - no flags BUT stdin is not a TTY → fail with a clear error instead of hanging
+  //  - otherwise → interactive
   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' +
+      'This terminal does not support interactive mode (stdin is not a TTY).\n' +
+      '  → Run it in Terminal.app/iTerm, OR use flags:\n' +
       '    create-app --name my-shop --mobile expo --fe nextjs --be nestjs',
     );
   } else {
@@ -168,13 +168,13 @@ async function main() {
   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.
+  const msg = `Done! Next:\n\n  cd ${rel} && pnpm install\n`;
+  // outro() (clack) only looks good in a TTY; print plainly in non-interactive mode.
   if (process.stdout.isTTY && !hasSelectionFlags(args)) outro(msg);
   else console.log(msg);
 }
 
 main().catch((err) => {
-  console.error('\n✗ Lỗi:', err.message);
+  console.error('\n✗ Error:', err.message);
   process.exit(1);
 });

package/src/prompts.js

@@ -1,8 +1,8 @@
-// prompts.js — logic hỏi tương tác.
+// prompts.js — interactive prompt logic.
 //
-// Trả về một "plan" thuần data để generate.js thực thi:
+// Returns a pure-data "plan" for generate.js to execute:
 //   { projectName, selections: [{ group, option }, ...] }
-// Không làm I/O ra ổ đĩa ở đây — chỉ hỏi và validate.
+// No disk I/O happens here — this only asks and validates.
 
 import {
   intro,
@@ -17,47 +17,47 @@ import { GROUPS, findOption } from './registry.js';
 
 function ensureNotCancelled(value) {
   if (isCancel(value)) {
-    cancel('Đã huỷ. Không có gì được tạo.');
+    cancel('Cancelled. Nothing was created.');
     process.exit(0);
   }
   return value;
 }
 
 export async function runPrompts() {
-  intro('create-app — sinh monorepo sản phẩm từ template công ty');
+  intro('create-app — scaffold a product monorepo from company templates');
 
-  // 1) Tên project
+  // 1) Project name
   const projectName = ensureNotCancelled(
     await text({
-      message: 'Tên project?',
+      message: 'Project name?',
       placeholder: 'my-shop',
       validate(value) {
         const v = (value ?? '').trim();
-        if (!v) return 'Tên project không được để trống.';
+        if (!v) return 'Project name must not be empty.';
         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 'Use only letters, numbers, "-" or "_", and start with a letter/number.';
         }
         return undefined;
       },
     }),
   );
 
-  // 2) Multi-select các nhóm cần (chọn được nhiều)
+  // 2) Multi-select the groups to include (you can pick several)
   const groupIds = ensureNotCancelled(
     await multiselect({
-      message: 'Chọn các nhóm cần (Space để chọn, Enter để xác nhận):',
+      message: 'Select the groups you need (Space to select, Enter to confirm):',
       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ệ
+  // 3) For each selected group → single-select one technology
   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ệ`,
+        message: `${group.label}: pick one technology`,
         options: group.options.map((o) => ({ value: o.id, label: o.label })),
       }),
     );

package/src/registry.js

@@ -1,15 +1,15 @@
-// registry.js — KHAI BÁO các nhóm + tech + đường dẫn template.
+// registry.js — declares all groups + technologies + template paths.
 //
-// Đâ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.
+// This is the single source of truth for adding/removing templates. To add a new
+// technology, just add one object to the relevant group's `options` (or add a whole
+// new group). You do NOT need to touch the logic in 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
+// Each option:
+//   id           : short identifier (used internally)
+//   label        : display label shown when prompting
+//   templatePath : path to the template, RELATIVE TO the company-starter repo root
 //   lang         : 'js' | 'dart' | 'php' ...
-//                  Chỉ option có lang === 'js' mới đủ điều kiện dùng packages/shared.
+//                  Only options with lang === 'js' are eligible to use packages/shared.
 
 export const GROUPS = [
   {
@@ -43,11 +43,11 @@ export const GROUPS = [
   },
 ];
 
-// path tới folder template dùng chung (chỉ copy khi >= 2 lựa chọn lang === 'js')
+// Path to the shared template folder (only copied when >= 2 selections have 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).
+// Quickly look up a single option by (groupId, optionId).
 export function findOption(groupId, optionId) {
   const group = GROUPS.find((g) => g.id === groupId);
   if (!group) return null;

package/templates/be/nestjs/README.md

@@ -1,11 +1,11 @@
 # Placeholder: NestJS (be/nestjs)
 
-Đây là **placeholder** cho template **NestJS**.
+This is a **placeholder** for the **NestJS** template.
 
-Bỏ source chuẩn của NestJS vào đây. Lưu ý quy ước:
+Drop the standard NestJS source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/be/nestjs/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-backend",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder NestJS backend cho {{PROJECT_NAME}}"
+  "description": "Placeholder NestJS backend for {{PROJECT_NAME}}"
 }

package/templates/be/nodejs/README.md

@@ -1,11 +1,11 @@
 # Placeholder: Node.js (be/nodejs)
 
-Đây là **placeholder** cho template **Node.js**.
+This is a **placeholder** for the **Node.js** template.
 
-Bỏ source chuẩn của Node.js backend vào đây. Lưu ý quy ước:
+Drop the standard Node.js backend source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/be/nodejs/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-backend",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder Node.js backend cho {{PROJECT_NAME}}"
+  "description": "Placeholder Node.js backend for {{PROJECT_NAME}}"
 }

package/templates/be/php/README.md

@@ -1,15 +1,15 @@
 # Placeholder: PHP (be/php)
 
-Đây là **placeholder** cho template **PHP**.
+This is a **placeholder** for the **PHP** template.
 
-Bỏ source chuẩn của PHP backend vào đây.
+Drop the standard PHP backend source here.
 
-> **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).
+> **Notes specific to PHP (`lang: php`):**
+> - **No** `_package.json` (PHP uses `composer.json`, not npm).
+> - **Not** part of the project's npm/pnpm workspaces.
+> - **Does not** use `packages/shared` (shared is JS/TS only).
 >
-> 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`).
+> On generate, the CLI still copies this whole folder into `apps/backend` and replaces
+> `{{PROJECT_NAME}}` in text files (e.g. `composer.json`, `README.md`).
 
-Bạn có thể đặt `{{PROJECT_NAME}}` trong `composer.json` để CLI tự điền tên project.
+You can put `{{PROJECT_NAME}}` in `composer.json` and the CLI will fill in the project name.

package/templates/fe/nextjs/README.md

@@ -1,11 +1,11 @@
 # Placeholder: Next.js (fe/nextjs)
 
-Đây là **placeholder** cho template **Next.js**.
+This is a **placeholder** for the **Next.js** template.
 
-Bỏ source chuẩn của Next.js vào đây. Lưu ý quy ước:
+Drop the standard Next.js source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/fe/nextjs/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-web",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder Next.js app cho {{PROJECT_NAME}}"
+  "description": "Placeholder Next.js app for {{PROJECT_NAME}}"
 }

package/templates/fe/reactjs/README.md

@@ -1,11 +1,11 @@
 # Placeholder: ReactJS (fe/reactjs)
 
-Đây là **placeholder** cho template **ReactJS**.
+This is a **placeholder** for the **ReactJS** template.
 
-Bỏ source chuẩn của ReactJS vào đây. Lưu ý quy ước:
+Drop the standard ReactJS source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/fe/reactjs/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-web",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder ReactJS app cho {{PROJECT_NAME}}"
+  "description": "Placeholder ReactJS app for {{PROJECT_NAME}}"
 }

package/templates/mobile/expo/README.md

@@ -1,11 +1,11 @@
 # Placeholder: Expo (mobile/expo)
 
-Đây là **placeholder** cho template **Expo**.
+This is a **placeholder** for the **Expo** template.
 
-Bỏ source chuẩn của Expo vào đây. Lưu ý quy ước:
+Drop the standard Expo source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/mobile/expo/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-mobile",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder Expo app cho {{PROJECT_NAME}}"
+  "description": "Placeholder Expo app for {{PROJECT_NAME}}"
 }

package/templates/mobile/flutter/README.md

@@ -1,15 +1,15 @@
 # Placeholder: Flutter (mobile/flutter)
 
-Đây là **placeholder** cho template **Flutter**.
+This is a **placeholder** for the **Flutter** template.
 
-Bỏ source chuẩn của Flutter (Dart) vào đây.
+Drop the standard Flutter (Dart) source here.
 
-> **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).
+> **Notes specific to Flutter (`lang: dart`):**
+> - **No** `_package.json` (Flutter uses `pubspec.yaml`, not npm).
+> - **Not** part of the project's npm/pnpm workspaces.
+> - **Does not** use `packages/shared` (shared is JS/TS only).
 >
-> 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`).
+> On generate, the CLI still copies this whole folder into `apps/mobile` and replaces
+> `{{PROJECT_NAME}}` in text files (e.g. `pubspec.yaml`, `README.md`).
 
-Bạn có thể đặt `{{PROJECT_NAME}}` trong `pubspec.yaml` để CLI tự điền tên project.
+You can put `{{PROJECT_NAME}}` in `pubspec.yaml` and the CLI will fill in the project name.

package/templates/mobile/rn/README.md

@@ -1,11 +1,11 @@
 # Placeholder: React Native (mobile/rn)
 
-Đây là **placeholder** cho template **React Native**.
+This is a **placeholder** for the **React Native** template.
 
-Bỏ source chuẩn của React Native vào đây. Lưu ý quy ước:
+Drop the standard React Native source here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Name `.gitignore` as **`_gitignore`**, `.npmrc` as **`_npmrc`** if present.
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-`lang: js` → app này được tính vào điều kiện tạo `packages/shared`.
+`lang: js` → this app counts toward the condition for creating `packages/shared`.

package/templates/mobile/rn/_package.json

@@ -2,5 +2,5 @@
   "name": "{{PROJECT_NAME}}-mobile",
   "version": "0.1.0",
   "private": true,
-  "description": "Placeholder React Native app cho {{PROJECT_NAME}}"
+  "description": "Placeholder React Native app for {{PROJECT_NAME}}"
 }

package/templates/shared/README.md

@@ -1,11 +1,11 @@
 # Placeholder: shared (packages/shared)
 
-Đây là **placeholder** cho package dùng chung của hệ **JS/TS**: types + api client.
+This is a **placeholder** for the shared **JS/TS** package: shared 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:
+Drop the standard shared source (types, api client, ...) for the JS/TS apps here. Conventions:
 
-- Đặ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.
+- Name the template's `package.json` as **`_package.json`** (the CLI renames it on generate).
+- Wherever you need the project name, write `{{PROJECT_NAME}}` — the CLI replaces it with the real name.
 
-> 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.
+> This package is **created only** when the project has **>= 2** selections with `lang === 'js'`.
+> Otherwise the CLI skips it and prints a notice.

package/templates/shared/_package.json

@@ -2,7 +2,7 @@
   "name": "@{{PROJECT_NAME}}/shared",
   "version": "0.1.0",
   "private": true,
-  "description": "Types + api client dùng chung cho {{PROJECT_NAME}}",
+  "description": "Shared types + api client for {{PROJECT_NAME}}",
   "main": "index.js",
   "type": "module"
 }

package/templates/shared/index.js

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