create-fer 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# create-fer
+
+CLI tạo project từ thư mục `template/` (đóng gói sẵn trong package).
+
+## Cấu trúc
+
+```
+template/          <-- Nơi chứa toàn bộ source code mẫu
+bin/
+  cli.js           <-- File thực thi chính khi chạy lệnh
+package.json
+README.md
+```
+
+## Dùng thử local (trong repo)
+
+```bash
+node bin/cli.js my-app
+```
+
+## Dùng qua npx (sau khi publish)
+
+```bash
+npx create-fer my-app
+```
+
+## Cấu hình quan trọng trong package.json
+
+- Trường `bin` để ánh xạ command:
+  - `create-fer` -> `bin/cli.js`
+- Trường `files` để đảm bảo npm publish mang theo `template/`, `bin/`, `README.md`
+
+## Publish lên npm
+
+1) Đổi tên package (phải unique trên npm):
+- sửa `name` trong `package.json` (ví dụ: `@your-scope/create-fer`)
+
+2) Đăng nhập npm:
+
+```bash
+npm login
+```
+
+3) Publish:
+
+```bash
+npm publish
+```
+
+Nếu dùng scope private/public:
+
+```bash
+npm publish --access public
+```
+

package/bin/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * create-fer - CLI scaffold tool
+ *
+ * Usage:
+ *   npx create-fer my-app
+ *   create-fer my-app
+ *   create-fer .            # scaffold into current directory
+ *
+ * Flags:
+ *   --help
+ *   --force                 # overwrite existing files
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+function printHelp() {
+    console.log(`
+create-fer
+
+Scaffold a project from the bundled template.
+
+Usage:
+  create-fer <project-name|.> [--force]
+
+Examples:
+  npx create-fer my-app
+  npx create-fer .
+  create-fer my-app --force
+`.trim());
+}
+
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const out = { target: null, force: false, help: false };
+    for (const a of args) {
+        if (a === "--help" || a === "-h") out.help = true;
+        else if (a === "--force" || a === "-f") out.force = true;
+        else if (!out.target) out.target = a;
+    }
+    return out;
+}
+
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+
+function copyDir(srcDir, destDir, force) {
+    ensureDir(destDir);
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const e of entries) {
+        const src = path.join(srcDir, e.name);
+        const dest = path.join(destDir, e.name);
+        if (e.isDirectory()) {
+            copyDir(src, dest, force);
+            continue;
+        }
+        if (fs.existsSync(dest) && !force) {
+            throw new Error(
+                `File exists: ${path.relative(process.cwd(), dest)} (use --force to overwrite)`
+            );
+        }
+        ensureDir(path.dirname(dest));
+        fs.copyFileSync(src, dest);
+    }
+}
+
+function main() {
+    const { target, force, help } = parseArgs(process.argv);
+    if (help) {
+        printHelp();
+        process.exit(0);
+    }
+
+    if (!target) {
+        printHelp();
+        process.exit(1);
+    }
+
+    const templateDir = path.resolve(__dirname, "..", "template");
+    if (!fs.existsSync(templateDir)) {
+        console.error("Missing template directory:", templateDir);
+        process.exit(1);
+    }
+
+    const destDir =
+        target === "." ? process.cwd() : path.resolve(process.cwd(), target);
+
+    try {
+        copyDir(templateDir, destDir, force);
+        console.log("✅ Created project at:", destDir);
+        if (target !== ".") {
+            console.log(`Next:\n  cd ${target}\n  npm install\n  npm run dev`);
+        } else {
+            console.log("Next:\n  npm install\n  npm run dev");
+        }
+    } catch (err) {
+        console.error("❌ Failed:", err && err.message ? err.message : err);
+        process.exit(1);
+    }
+}
+
+main();
+

package/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "create-fer",
+    "version": "0.1.0",
+    "description": "Scaffold a FER project from a template",
+    "license": "MIT",
+    "author": "",
+    "repository": {
+        "type": "git",
+        "url": ""
+    },
+    "keywords": [
+        "cli",
+        "scaffold",
+        "template",
+        "create"
+    ],
+    "type": "commonjs",
+    "bin": {
+        "create-fer": "bin/cli.js"
+    },
+    "files": [
+        "bin/",
+        "template/",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18"
+    },
+    "scripts": {
+        "test": "node bin/cli.js --help"
+    }
+}

package/template/index.js

@@ -0,0 +1,2 @@
+console.log("Hello from FER template!");
+

package/template/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "fer-app",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "node index.js",
+    "start": "node index.js"
+  }
+}
+