create-reactivite 1.3.0 → 1.4.0

package/README.md

@@ -4,7 +4,7 @@ A modern frontend boilerplate generator. On run it asks which template you want,
 
 ## 🚀 Templates
 
-When you run the CLI you pick one of two templates:
+When you run the CLI you pick one of three templates:
 
 | Template | Stack |
 | --- | --- |
@@ -48,6 +48,32 @@ npx create-reactivite .
 
 Dependencies install automatically (`pnpm`, falling back to `npm`).
 
+## 🛠️ CLI usage
+
+The CLI runs interactively (prompts) or non-interactively (flags) — flags skip the matching prompt, so it works in scripts and CI.
+
+```
+npx create-reactivite [name] [options]
+```
+
+| Argument / Flag | Alias | Description |
+| --- | --- | --- |
+| `name` | | Project folder. Use `.` to scaffold into the current directory. Omit to be prompted. Must be lowercase letters, digits, `-` `.` `_` `~`. |
+| `--template <name>` | `-t` | `template` · `template2` · `template3`. Omit to be prompted. |
+| `--help` | `-h` | Print usage and exit. |
+| `--version` | `-v` | Print version and exit. |
+
+```bash
+# fully non-interactive (no prompts)
+npx create-reactivite my-app --template template2
+npx create-reactivite my-app -t template3
+
+npx create-reactivite --help
+npx create-reactivite --version
+```
+
+After copying the template the CLI sets `name` in the new `package.json`, removes any bundled lockfile (fresh resolve), runs `git init`, then installs dependencies.
+
 ---
 
 ## ⚛️ Template 1 — React + Vite
@@ -215,6 +241,35 @@ npx shadcn@latest add button
 npx shadcn@latest add form
 ```
 
+## 🔄 Maintaining template versions
+
+This repo ships a Claude Code skill that bumps every template's dependencies to their latest published versions in one shot — useful when keeping the scaffolds current.
+
+```
+/update-template-deps
+```
+
+It runs `npm-check-updates` inside `template/`, `template2/` and `template3/`, rewrites each `package.json` to the latest, and reports what changed — flagging **major** bumps that need a build check. The generator's own root `package.json` is left untouched.
+
+You can also run the helper directly:
+
+```bash
+# all templates, latest (includes majors)
+node .claude/skills/update-template-deps/update-deps.mjs
+
+# safe — no major bumps
+node .claude/skills/update-template-deps/update-deps.mjs --target minor
+
+# a single template
+node .claude/skills/update-template-deps/update-deps.mjs --template template2
+```
+
+After a major bump, verify the affected template still builds before publishing:
+
+```bash
+cd template2 && pnpm install && pnpm build
+```
+
 ## 🤝 Contributing
 
 Contributions welcome — open a PR.

package/index.js

@@ -15,6 +15,53 @@ const __dirname = path.dirname(__filename);
 const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 
+// Mövcud template-lər (CLI seçim + --template flag validasiyası üçün)
+const TEMPLATES = ["template", "template2", "template3"];
+
+// 🧩 argv parse — `name` positional + `--template/-t <val>` + `--help/--version`
+const parseArgs = (argv) => {
+  const args = { _: [], template: undefined, help: false, version: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--help" || a === "-h") args.help = true;
+    else if (a === "--version" || a === "-v") args.version = true;
+    else if (a === "--template" || a === "-t") args.template = argv[++i];
+    else if (a.startsWith("--template=")) args.template = a.split("=")[1];
+    else if (!a.startsWith("-")) args._.push(a);
+  }
+  return args;
+};
+
+const printHelp = () => {
+  console.log(`
+  ${cyan("create-reactivite")} — scaffold React / Next.js / Rspack apps
+
+  ${dim("Usage:")}
+    npx create-reactivite [name] [options]
+
+  ${dim("Options:")}
+    -t, --template <name>   ${TEMPLATES.join(" | ")}
+    -h, --help              Show this help
+    -v, --version           Show version
+
+  ${dim("Examples:")}
+    npx create-reactivite my-app
+    npx create-reactivite my-app --template template2
+    npx create-reactivite .
+`);
+};
+
+const getVersion = () => {
+  try {
+    const pkg = JSON.parse(
+      fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
+    );
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+};
+
 // 🧩 Banner — CLI açılışında göstərilir
 const printBanner = () => {
   try {
@@ -27,42 +74,92 @@ const printBanner = () => {
 };
 
 (async () => {
+  const argv = parseArgs(process.argv.slice(2));
+
+  // --version / --help erkən çıxış (banner olmadan)
+  if (argv.version) {
+    console.log(getVersion());
+    process.exit(0);
+  }
+  if (argv.help) {
+    printHelp();
+    process.exit(0);
+  }
+
   printBanner();
 
-  const { projectName } = await prompts({
-    type: "text",
-    name: "projectName",
-    message: "Project name:",
-    initial: "my-react-app",
-  });
-
-  // 🧩 0. Hansı template istifadə olunacaq — istifadəçi seçir
-  const { template } = await prompts({
-    type: "select",
-    name: "template",
-    message: "Pick a template:",
-    choices: [
-      {
-        title: "React + Vite (Tailwind v4, shadcn/ui, React Router)",
-        value: "template",
-      },
-      {
-        title:
-          "Next.js 16 (App Router, i18n, TanStack Query, orval, Zustand, husky)",
-        value: "template2",
-      },
-      {
-        title: "Rspack (minimal React + TypeScript starter)",
-        value: "template3",
-      },
-    ],
-    initial: 0,
-  });
-
-  // İstifadəçi seçimi ləğv etdisə (Ctrl+C) — çıx
-  if (!template) {
-    console.log("❌ Operation cancelled.");
-    process.exit(1);
+  const nameRegex = /^[a-z0-9-~][a-z0-9-._~]*$/;
+
+  // 🧩 Layihə adı — argv-dən gəlirsə validasiya et, yoxsa soruş
+  let projectName = argv._[0];
+  if (projectName !== undefined) {
+    if (
+      projectName !== "." &&
+      projectName !== "./" &&
+      !nameRegex.test(projectName)
+    ) {
+      console.error(
+        `❌ Invalid project name "${projectName}" (lowercase letters, digits, - . _ ~ only)`
+      );
+      process.exit(1);
+    }
+  } else {
+    const res = await prompts({
+      type: "text",
+      name: "projectName",
+      message: "Project name:",
+      initial: "my-react-app",
+      // npm paket adı qaydası: kiçik hərf, rəqəm, - . _ ~ (və `.` current dir)
+      validate: (name) =>
+        name === "." || name === "./" || nameRegex.test(name)
+          ? true
+          : "Invalid name (lowercase letters, digits, - . _ ~ only)",
+    });
+    projectName = res.projectName;
+    // Ctrl+C name promptunda — çıx
+    if (projectName === undefined) {
+      console.log("❌ Operation cancelled.");
+      process.exit(1);
+    }
+  }
+
+  // 🧩 0. Template — argv-dən gəlirsə validasiya et, yoxsa soruş
+  let template = argv.template;
+  if (template !== undefined) {
+    if (!TEMPLATES.includes(template)) {
+      console.error(
+        `❌ Unknown template "${template}". Valid: ${TEMPLATES.join(", ")}`
+      );
+      process.exit(1);
+    }
+  } else {
+    const res = await prompts({
+      type: "select",
+      name: "template",
+      message: "Pick a template:",
+      choices: [
+        {
+          title: "React + Vite (Tailwind v4, shadcn/ui, React Router)",
+          value: "template",
+        },
+        {
+          title:
+            "Next.js 16 (App Router, i18n, TanStack Query, orval, Zustand, husky)",
+          value: "template2",
+        },
+        {
+          title: "Rspack (minimal React + TypeScript starter)",
+          value: "template3",
+        },
+      ],
+      initial: 0,
+    });
+    template = res.template;
+    // İstifadəçi seçimi ləğv etdisə (Ctrl+C) — çıx
+    if (!template) {
+      console.log("❌ Operation cancelled.");
+      process.exit(1);
+    }
   }
 
   // 🧩 1. Target folderı müəyyən edirik
@@ -108,6 +205,32 @@ const printBanner = () => {
     fs.renameSync(gitignoreSrc, path.join(targetPath, ".gitignore"));
   }
 
+  // 🧩 3a. Layihənin adını target package.json-a yazırıq
+  // (template-dən gələn ad `template`/`template2`/`template3` olur)
+  const pkgPath = path.join(targetPath, "package.json");
+  if (!isCurrentDir && fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      pkg.name = projectName;
+      fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    } catch {
+      // package.json oxunmadı — keç
+    }
+  }
+
+  // 🧩 3b. Köhnə lockfile-ları silirik ki, fresh resolve olsun
+  for (const lock of ["pnpm-lock.yaml", "package-lock.json", "yarn.lock"]) {
+    const lockPath = path.join(targetPath, lock);
+    if (fs.existsSync(lockPath)) fs.rmSync(lockPath);
+  }
+
+  // 🧩 3c. git repo init (husky `prepare` skriptinin də işləməsi üçün)
+  try {
+    await execa("git", ["init"], { cwd: targetPath });
+  } catch {
+    // git yoxdursa — keç
+  }
+
   // 🧩 4. Asılılıqları quraşdırırıq
   console.log("📥 Installing dependencies...");
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-reactivite",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "⚡ Scaffold modern frontend projects in seconds — pick a template: React + Vite or Next.js 16 (App Router). Both ship Tailwind v4, shadcn/ui, TypeScript and a clean, production-ready structure. The Next.js template adds i18n, TanStack Query, axios/orval, Zustand, husky and Vitest. Zero setup hassle.",
   "bin": {
     "create-reactivite": "./index.js"
@@ -51,4 +51,4 @@
     "url": "https://github.com/jsznpm"
   },
   "license": "MIT"
-}
+}