@dawitworku/projectcli 0.1.4 → 0.2.1

package/README.md

@@ -1,75 +1,110 @@
-# projectcli
+# ProjectCLI 🚀
 
-Interactive project generator.
+> **The Swiss Army Knife for Project Scaffolding.**  
+> Bootstrapping new projects shouldn't require memorizing 50 different CLI commands.
 
-Run it as a single command, pick language → framework, and it scaffolds the project by calling the underlying official CLIs (Vite, Next.js, Nest, etc.).
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://badge.fury.io/js/@dawitworku%2Fprojectcli.svg)](https://badge.fury.io/js/@dawitworku%2Fprojectcli)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
 
-## Run with npx (recommended)
+**ProjectCLI** is an interactive, cross-language project generator. Instead of remembering usage for `create-react-app`, `cargo new`, `poetry new`, `laravel new`, `rails new`, etc., just run `projectcli`.
 
-After you publish this package to npm:
+We handle the complexity of calling the official CLIs for you.
+
+## ✨ Features
+
+- **Multi-Language Support**: Rust, Go, Python, JavaScript, TypeScript, PHP, Java, C#, Ruby, Swift, Dart.
+- **Unified Interface**: One interactive wizard to rule them all.
+- **Smart Context Awareness**: Running `projectcli` inside an existing project automatically offers to add libraries, CI/CD, or Dockerfiles tailored to that language.
+- **Preflight Checks**: Warns you if you are missing required tools (e.g. `cargo`, `go`, `node`) before you start.
+- **Remote Templates**: Clone any GitHub repository and automatically strip `.git` history for a fresh start.
+- **CI/CD & Docker**: One-click generation of GitHub Actions workflows and Dockerfiles.
+
+## 🚀 Quick Start
+
+Run instantly with `npx`:
 
 ```bash
 npx @dawitworku/projectcli@latest
 ```
 
-You can also run non-interactively:
+Or install globally:
 
 ```bash
-npx @dawitworku/projectcli@latest --language "TypeScript" --framework "NestJS" --name my-api --pm npm
+npm install -g @dawitworku/projectcli
+projectcli
 ```
 
-## Run (dev)
+## 🎮 Interactive Mode
+
+Just run `projectcli` and follow the prompts:
+
+1. Select **Language** (fuzzy search supported).
+2. Select **Framework** (React, Vue, Next.js, Actix, Axum, Django, FastAPI, etc.).
+3. Choose **Project Name**.
+4. (Optional) Add **CI/CD** or **Docker**.
+
+## 🛠 Advanced Usage
+
+### Context Awareness
+
+Run it inside a project to detect the language and offer relevant tools:
 
 ```bash
-npm install
-npm start
+cd my-rust-project
+projectcli
+# Output: "✓ Detected active Rust project"
+# Options: [Add GitHub Actions CI], [Add Dockerfile], [Add Dependencies]
 ```
 
-## Install as a single-word command
+### Remote Templates
 
-From this repo folder:
+Clone a starter kit from GitHub and make it your own instantly:
 
 ```bash
-npm install
-npm link
+projectcli --template https://github.com/example/starter-repo --name my-app
 ```
 
-Then you can run:
+### Automation / CI Use
+
+Skip the interactive prompts for scripts or specialized workflows:
 
 ```bash
-projectcli
+projectcli --language Rust --framework Actix --name my-api --ci --docker --yes
 ```
 
-## Add libraries to an existing project
+### Configuration
 
-Run inside a project folder:
+Save your preferences (like default package manager):
 
 ```bash
-projectcli add
+projectcli config
 ```
 
-## Notes
+## 📦 Supported Generators (Partial List)
 
-- If you type a project name that already exists, the CLI will ask for another name (it won’t quit).
-- Some generators (like Vite/Next/etc.) can still ask their own questions — those prompts come from the underlying tool.
+| Language                  | Frameworks / Tools                                            |
+| ------------------------- | ------------------------------------------------------------- |
+| **JavaScript/TypeScript** | React (Vite), Vue, Next.js, NestJS, Express, Astro, Svelte... |
+| **Rust**                  | Binary, Library, Actix Web, Axum, Rocket, Taurus...           |
+| **Python**                | Poetry, Setuptools, Django, Flask, FastAPI...                 |
+| **Go**                    | Binary, Fiber, Gin, Chi, Echo...                              |
+| **PHP**                   | Laravel, Symfony, Slim...                                     |
+| **Java/Kotlin**           | Spring Boot, Gradle/Maven...                                  |
+| **...and more**           | C#, Ruby, Swift, Dart                                         |
 
-## Useful flags
+## 🤝 Contributing
 
-```bash
-projectcli --help
-projectcli --version
-projectcli --list
-projectcli --language "JavaScript" --framework "Astro" --name myapp --pm pnpm
-projectcli --language "TypeScript" --framework "TanStack Start" --name myapp --pm npm
-projectcli --language "TypeScript" --framework "NestJS" --name myapi --pm pnpm
-projectcli --dry-run --language "JavaScript" --framework "Vite (React)" --name demo --pm pnpm
-```
+We love contributions! Whether it's adding a new framework to the registry or fixing a bug.
+
+1.  Fork it.
+2.  Create your feature branch (`git checkout -b feature/new-framework`).
+3.  Commit your changes (`git commit -am 'Add support for X'`).
+4.  Push to the branch (`git push origin feature/new-framework`).
+5.  Create a new Pull Request.
 
-## How it works
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
 
-- Choose language
-- Choose framework
-- Enter project name
-- CLI runs the underlying generator commands (npm/cargo/django-admin/etc.)
+## 📝 License
 
-If a generator command is missing on your machine, install it and re-run.
+MIT © [Dawit Worku](https://github.com/dawitworku)

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@dawitworku/projectcli",
-  "version": "0.1.4",
-  "description": "Interactive project generator (language -> framework -> create).",
+  "version": "0.2.1",
+  "description": "The ultimate interactive project generator (language -> framework -> create).",
+  "author": "Dawit Worku",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dawitworku/projectcli"
+  },
+  "bugs": {
+    "url": "https://github.com/dawitworku/projectcli/issues"
+  },
+  "homepage": "https://github.com/dawitworku/projectcli#readme",
   "license": "MIT",
   "type": "commonjs",
   "bin": {

package/src/cicd.js

@@ -0,0 +1,169 @@
+const fs = require("node:fs");
+const path = require("node:path");
+
+const GITHUB_ACTIONS_JS = `name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run build --if-present
+      - run: npm test --if-present
+`;
+
+const GITHUB_ACTIONS_PY = `name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+      - run: pip install -r requirements.txt
+`;
+
+const GITHUB_ACTIONS_RUST = `name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo build --verbose
+      - run: cargo test --verbose
+`;
+
+const GITHUB_ACTIONS_GO = `name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.21'
+      - run: go build -v ./...
+      - run: go test -v ./...
+`;
+
+function getGitHubAction(language, pm) {
+  if (language === "JavaScript" || language === "TypeScript")
+    return GITHUB_ACTIONS_JS;
+  if (language === "Python") return GITHUB_ACTIONS_PY;
+  if (language === "Rust") return GITHUB_ACTIONS_RUST;
+  if (language === "Go") return GITHUB_ACTIONS_GO;
+  // Default generic
+  return `name: CI
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: echo "Add build steps here"
+`;
+}
+
+const DOCKERFILE_JS = `FROM node:20-alpine AS base
+
+FROM base AS deps
+WORKDIR /app
+COPY package.json ./
+RUN npm install
+
+FROM base AS runner
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+# RUN npm run build
+CMD ["node", "index.js"]
+`;
+
+const DOCKERFILE_PY = `FROM python:3.11-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+COPY . .
+CMD ["python", "app.py"]
+`;
+
+const DOCKERFILE_GO = `FROM golang:1.21-alpine AS builder
+WORKDIR /app
+COPY . .
+RUN go build -o myapp main.go
+
+FROM alpine:latest
+WORKDIR /app
+COPY --from=builder /app/myapp .
+CMD ["./myapp"]
+`;
+
+const DOCKERFILE_RUST = `FROM rust:1.75 as builder
+WORKDIR /usr/src/myapp
+COPY . .
+RUN cargo install --path .
+
+FROM debian:buster-slim
+COPY --from=builder /usr/local/cargo/bin/myapp /usr/local/bin/myapp
+CMD ["myapp"]
+`;
+
+function getDockerfile(language) {
+  if (language === "JavaScript" || language === "TypeScript")
+    return DOCKERFILE_JS;
+  if (language === "Python") return DOCKERFILE_PY;
+  if (language === "Go") return DOCKERFILE_GO;
+  if (language === "Rust") return DOCKERFILE_RUST;
+  return `# Dockerfile
+FROM ubuntu:latest
+WORKDIR /app
+COPY . .
+CMD ["echo", "Start..."]
+`;
+}
+
+function generateCI(projectRoot, language, pm) {
+  const steps = [];
+
+  // GitHub Actions
+  const ghContent = getGitHubAction(language, pm);
+  steps.push({
+    type: "writeFile",
+    path: ".github/workflows/ci.yml",
+    content: ghContent,
+  });
+
+  return steps;
+}
+
+function generateDocker(projectRoot, language) {
+  const content = getDockerfile(language);
+  return [
+    {
+      type: "writeFile",
+      path: "Dockerfile",
+      content: content,
+    },
+    {
+      type: "writeFile",
+      path: ".dockerignore",
+      content: "node_modules\ntarget\n.venv\n.git\n",
+    },
+  ];
+}
+
+module.exports = {
+  generateCI,
+  generateDocker,
+};

package/src/config.js

@@ -0,0 +1,34 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+
+const CONFIG_PATH = path.join(os.homedir(), ".projectcli.json");
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      const content = fs.readFileSync(CONFIG_PATH, "utf8");
+      return JSON.parse(content);
+    }
+  } catch (err) {
+    // ignore
+  }
+  return {};
+}
+
+function saveConfig(data) {
+  try {
+    const current = loadConfig();
+    const updated = { ...current, ...data };
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(updated, null, 2));
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+module.exports = {
+  loadConfig,
+  saveConfig,
+  CONFIG_PATH,
+};

package/src/descriptions.js

@@ -0,0 +1,45 @@
+const DESCRIPTIONS = {
+  // JavaScript
+  "js.vite.vanilla":
+    "Native ESM-based build tool. Best for: fast prototyping, zero-framework learning.",
+  "js.vite.react":
+    "Most popular UI library. Best for: interactive UIs, large ecosystem, jobs.",
+  "js.vite.vue":
+    "Progressive framework. Best for: easy learning curve, clean template syntax.",
+  "js.vite.svelte":
+    "Compiler-based framework. Best for: performance, less boilerplate, true reactivity.",
+  "js.nextjs":
+    "The React Framework for the Web. Best for: SEO, SSR/SSG, full-stack apps.",
+  "js.astro":
+    "Content-focused site builder. Best for: blogs, documentation, portfolios (ships less JS).",
+  "js.express":
+    "Minimalist web framework for Node.js. Best for: REST APIs, learning backend basics.",
+  "js.nestjs":
+    "Angular-style backend framework. Best for: enterprise, scalable architecture, TypeScript.",
+
+  // Python
+  "py.django":
+    "Batteries-included web framework. Best for: rapid dev, CMS, huge ecosystem.",
+  "py.flask.basic":
+    "Microframework. Best for: simple services, learning, flexibility.",
+  "py.fastapi.basic":
+    "Modern, fast (high-performance). Best for: APIs with auto-docs (Swagger), async support.",
+
+  // Rust
+  "rs.cargo.bin":
+    "Standard Rust binary. Best for: CLI tools, backend services, learning Rust.",
+  "rs.tauri":
+    "Build smaller, faster, and more secure desktop applications with a web frontend.",
+
+  // Go
+  "go.module.basic":
+    "Go's dependency management system. Best for: microservices, high concurrency.",
+};
+
+function getDescription(id) {
+  return DESCRIPTIONS[id] || "No description available.";
+}
+
+module.exports = {
+  getDescription,
+};

package/src/index.js

@@ -28,6 +28,13 @@ try {
 const { getLanguages, getFrameworks, getGenerator } = require("./registry");
 const { runSteps } = require("./run");
 const { runAdd } = require("./add");
+const { checkBinaries } = require("./preflight");
+const { gitClone, removeGitFolder } = require("./remote");
+const { generateCI, generateDocker } = require("./cicd");
+const { getDescription } = require("./descriptions");
+const { detectLanguage, detectPackageManager } = require("./detect");
+const { loadConfig } = require("./config");
+const { runConfig } = require("./settings");
 
 const RUST_KEYWORDS = new Set(
   [
@@ -129,6 +136,10 @@ function parseArgs(argv) {
     framework: undefined,
     name: undefined,
     pm: undefined,
+    ci: false,
+    docker: false,
+    learning: false,
+    template: undefined,
   };
 
   const nextValue = (i) => {
@@ -143,7 +154,15 @@ function parseArgs(argv) {
     else if (a === "--list") out.list = true;
     else if (a === "--yes" || a === "-y") out.yes = true;
     else if (a === "--dry-run") out.dryRun = true;
-    else if (a.startsWith("--language="))
+    else if (a === "--ci") out.ci = true;
+    else if (a === "--docker") out.docker = true;
+    else if (a === "--learning") out.learning = true;
+    else if (a.startsWith("--template="))
+      out.template = a.slice("--template=".length);
+    else if (a === "--template") {
+      out.template = nextValue(i);
+      i++;
+    } else if (a.startsWith("--language="))
       out.language = a.slice("--language=".length);
     else if (a === "--language") {
       out.language = nextValue(i);
@@ -189,6 +208,7 @@ function printHelp() {
   console.log(
     "  projectcli --language <lang> --framework <fw> --name <project>"
   );
+  console.log("  projectcli config        # configure defaults");
   console.log("");
   console.log("Flags:");
   console.log("  --help, -h       Show help");
@@ -202,9 +222,14 @@ function printHelp() {
   console.log(
     "  --pm             Package manager for JS/TS (npm|pnpm|yarn|bun)"
   );
+  console.log("  --ci             Auto-add GitHub Actions CI");
+  console.log("  --docker         Auto-add Dockerfile");
+  console.log("  --learning       Enable learning mode (shows descriptions)");
+  console.log("  --template       Clone from a Git repository URL");
 }
 
 const BACK = "__back__";
+const COMMUNITY = "Community / Remote";
 
 function withBack(choices) {
   return [
@@ -247,6 +272,18 @@ function printList() {
   }
 }
 
+function showBanner() {
+  console.log("");
+  console.log(
+    gradient.pastel.multiline(
+      figlet.textSync("ProjectCLI", { font: "Standard" })
+    )
+  );
+  console.log(chalk.bold.magenta("  The Swiss Army Knife for Developers"));
+  console.log(chalk.dim("  v" + readPackageVersion()));
+  console.log("");
+}
+
 async function main(options = {}) {
   if (!prompt) {
     throw new Error(
@@ -257,7 +294,19 @@ async function main(options = {}) {
   const argv = options.argv || [];
   const { cmd, rest } = splitCommand(argv);
   const args = parseArgs(rest);
+
+  if (
+    !args.list &&
+    !args.version &&
+    !args.help &&
+    rest.length === 0 &&
+    cmd === "init"
+  ) {
+    showBanner();
+  }
+
   if (args.help) {
+    showBanner();
     printHelp();
     return;
   }
@@ -275,6 +324,87 @@ async function main(options = {}) {
     return;
   }
 
+  if (cmd === "config") {
+    await runConfig({ prompt });
+    return;
+  }
+
+  // Smart Context Detection
+  if (
+    cmd === "init" &&
+    rest.length === 0 &&
+    !args.language &&
+    !args.framework &&
+    !args.template &&
+    !args.name
+  ) {
+    const detected = detectLanguage(process.cwd());
+    if (detected && detected !== "Unknown") {
+      console.clear();
+      console.log(
+        gradient.pastel.multiline(
+          figlet.textSync("ProjectCLI", { font: "Standard" })
+        )
+      );
+      console.log(chalk.bold.magenta("  The Swiss Army Knife for Developers"));
+      console.log("");
+      console.log(
+        chalk.green(`✓ Detected active ${chalk.bold(detected)} project.`)
+      );
+
+      const { action } = await prompt([
+        {
+          type: "list",
+          name: "action",
+          message: "What would you like to do?",
+          choices: [
+            { name: "Add Library / Dependency", value: "add" },
+            { name: "Add GitHub Actions CI", value: "ci" },
+            { name: "Add Dockerfile", value: "docker" },
+            new inquirer.Separator(),
+            { name: "Start New Project Here", value: "new" },
+            { name: "Exit", value: "exit" },
+          ],
+        },
+      ]);
+
+      if (action === "exit") process.exit(0);
+
+      if (action === "add") {
+        // reuse the add logic, passing empty args so it detects locally
+        await runAdd({ prompt, argv: [] });
+        return;
+      }
+
+      if (action === "ci" || action === "docker") {
+        const pm = detectPackageManager(process.cwd());
+        let langArg = detected;
+        if (detected === "JavaScript/TypeScript") langArg = "JavaScript";
+        if (detected === "Java/Kotlin") langArg = "Java";
+
+        const steps =
+          action === "ci"
+            ? generateCI(process.cwd(), langArg, pm)
+            : generateDocker(process.cwd(), langArg);
+
+        if (steps.length > 0) {
+          console.log("\nApplying changes...");
+          await runSteps(steps, { projectRoot: process.cwd() });
+          console.log(chalk.green("Done!"));
+        } else {
+          console.log(
+            chalk.yellow(
+              "No standard template available for this language yet."
+            )
+          );
+        }
+        return;
+      }
+
+      // If 'new', fall through to normal wizard
+    }
+  }
+
   // Clear console for a fresh start
   console.clear();
 
@@ -297,13 +427,26 @@ async function main(options = {}) {
     throw new Error("No languages configured.");
   }
 
+  const userConfig = loadConfig();
+
   const allowedPms = ["npm", "pnpm", "yarn", "bun"];
-  const preselectedPm =
+  let preselectedPm =
     typeof args.pm === "string" && allowedPms.includes(args.pm)
       ? args.pm
       : undefined;
 
+  if (!preselectedPm && userConfig.packageManager) {
+    if (allowedPms.includes(userConfig.packageManager)) {
+      preselectedPm = userConfig.packageManager;
+    }
+  }
+
+  if (userConfig.learningMode && args.learning === false) {
+    args.learning = true;
+  }
+
   const state = {
+    template: args.template || undefined,
     language:
       args.language && languages.includes(args.language)
         ? args.language
@@ -325,7 +468,10 @@ async function main(options = {}) {
     state.language === "JavaScript" || state.language === "TypeScript";
 
   let step = "language";
-  if (!state.language) step = "language";
+  if (state.template) {
+    if (!state.name) step = "name";
+    else step = "confirm";
+  } else if (!state.language) step = "language";
   else if (!state.framework) step = "framework";
   else if (needsPackageManager && !state.pm) step = "pm";
   else if (!state.name) step = "name";
@@ -418,6 +564,38 @@ async function main(options = {}) {
       }
 
       state.framework = answer.framework;
+
+      // Preflight Checks
+      const gen = getGenerator(state.language, state.framework);
+      if (gen && gen.check && gen.check.length > 0) {
+        /* eslint-disable-next-line no-console */
+        console.log(chalk.dim("\n(checking requirements...)"));
+        const results = await checkBinaries(gen.check);
+        const missing = results.filter((r) => !r.ok);
+
+        if (missing.length > 0) {
+          console.log(chalk.red.bold("\nMissing required tools:"));
+          missing.forEach((m) => console.log(chalk.red(` - ${m.bin}`)));
+          console.log(
+            chalk.yellow("You may not be able to build or run this project.\n")
+          );
+
+          const { proceed } = await prompt([
+            {
+              type: "confirm",
+              name: "proceed",
+              message: "Continue anyway?",
+              default: false,
+            },
+          ]);
+
+          if (!proceed) {
+            step = "framework";
+            continue;
+          }
+        }
+      }
+
       step = "pm";
       continue;
     }
@@ -493,6 +671,10 @@ async function main(options = {}) {
 
       const v = String(projectName || "").trim();
       if (v.toLowerCase() === "back") {
+        if (state.template) {
+          console.log("Operation cancelled.");
+          process.exit(0);
+        }
         step =
           state.language === "JavaScript" || state.language === "TypeScript"
             ? "pm"
@@ -506,13 +688,75 @@ async function main(options = {}) {
     }
 
     if (step === "confirm") {
+      const projectRoot = path.resolve(process.cwd(), state.name);
+      const targetExists = fs.existsSync(projectRoot);
+
+      if (state.template) {
+        if (targetExists && !args.dryRun) {
+          console.error(
+            `\nError: Target folder already exists: ${projectRoot}`
+          );
+          state.name = undefined;
+          step = "name";
+          continue;
+        }
+
+        console.log("\nProject Configuration:");
+        console.log(`  Template: ${state.template}`);
+        console.log(`  Folder:   ${state.name}`);
+        console.log("");
+
+        if (!args.yes) {
+          const { action } = await prompt([
+            {
+              type: "list",
+              name: "action",
+              message: "Clone this template?",
+              choices: [
+                { name: "Clone template", value: "create" },
+                { name: "Cancel", value: "cancel" },
+              ],
+            },
+          ]);
+          if (action === "cancel") {
+            console.log("Aborted.");
+            return;
+          }
+        }
+
+        if (args.dryRun) {
+          console.log(
+            `[Dry Run] Would clone ${state.template} to ${projectRoot}`
+          );
+          return;
+        }
+
+        console.log(chalk.dim("\nCloning repository..."));
+        try {
+          await gitClone(state.template, projectRoot);
+          // Remove .git to make it a fresh project
+          removeGitFolder(projectRoot);
+
+          console.log(
+            chalk.green(`\nSuccess! Created project at ${projectRoot}`)
+          );
+          console.log(
+            chalk.dim(
+              "You may need to run 'npm install' or similar inside the folder."
+            )
+          );
+        } catch (err) {
+          console.error(chalk.red("\nFailed to clone template:"), err.message);
+          process.exit(1);
+        }
+        return;
+      }
+
       const generator = getGenerator(state.language, state.framework);
       if (!generator) {
         throw new Error("Generator not found (registry mismatch).");
       }
 
-      const projectRoot = path.resolve(process.cwd(), state.name);
-      const targetExists = fs.existsSync(projectRoot);
       if (targetExists && !args.dryRun) {
         console.error(`\nError: Target folder already exists: ${projectRoot}`);
         state.name = undefined;
@@ -526,6 +770,20 @@ async function main(options = {}) {
         `Framework: ${state.framework}`,
       ];
       if (state.pm) summaryLines.push(`Package manager: ${state.pm}`);
+
+      if (args.learning) {
+        const desc = getDescription(generator.id);
+        console.log(
+          chalk.cyan(
+            boxen(desc, {
+              padding: 1,
+              title: `About ${state.framework}`,
+              borderStyle: "round",
+            })
+          )
+        );
+      }
+
       console.log("\n" + summaryLines.join("\n") + "\n");
 
       if (targetExists && args.dryRun) {
@@ -623,6 +881,83 @@ async function main(options = {}) {
         continue;
       }
 
+      // Git init
+      if (!args.dryRun) {
+        let doGit = args.yes;
+        if (!doGit) {
+          const { git } = await prompt([
+            {
+              type: "confirm",
+              name: "git",
+              message: "Initialize a new git repository?",
+              default: true,
+            },
+          ]);
+          doGit = git;
+        }
+
+        if (doGit) {
+          try {
+            await runSteps(
+              [
+                { program: "git", args: ["init"], cwdFromProjectRoot: true },
+                {
+                  program: "git",
+                  args: ["add", "."],
+                  cwdFromProjectRoot: true,
+                },
+                {
+                  program: "git",
+                  args: ["commit", "-m", "Initial commit"],
+                  cwdFromProjectRoot: true,
+                },
+              ],
+              { projectRoot }
+            );
+            console.log("Initialized git repository.");
+          } catch (e) {
+            console.warn("Git init failed (is git installed?):", e.message);
+          }
+        }
+      }
+
+      // CI/CD & Docker
+      if (!args.dryRun) {
+        let wantCi = args.ci;
+        let wantDocker = args.docker;
+
+        if (!args.yes) {
+          const { extras } = await prompt([
+            {
+              type: "checkbox",
+              name: "extras",
+              message: "Extras:",
+              choices: [
+                { name: "GitHub Actions CI", value: "ci", checked: wantCi },
+                { name: "Dockerfile", value: "docker", checked: wantDocker },
+              ],
+            },
+          ]);
+          if (extras) {
+            wantCi = extras.includes("ci");
+            wantDocker = extras.includes("docker");
+          }
+        }
+
+        const extraSteps = [];
+        if (wantCi) {
+          extraSteps.push(...generateCI(projectRoot, state.language, state.pm));
+        }
+        if (wantDocker) {
+          extraSteps.push(...generateDocker(projectRoot, state.language));
+        }
+
+        if (extraSteps.length > 0) {
+          console.log("Adding extras...");
+          await runSteps(extraSteps, { projectRoot });
+        }
+      }
+
       console.log(`\nDone. Created project in: ${projectRoot}`);
       return;
     }

package/src/libraries.js

@@ -137,11 +137,60 @@ const GO = {
   ],
 };
 
+const PHP = {
+  "Web Frameworks": [
+    { label: "Laravel", packages: ["laravel/framework"] },
+    { label: "Symfony", packages: ["symfony/symfony"] },
+    { label: "Slim", packages: ["slim/slim"] },
+  ],
+  Testing: [
+    { label: "PHPUnit", packages: [], packagesDev: ["phpunit/phpunit"] },
+    { label: "Pest", packages: [], packagesDev: ["pestphp/pest"] },
+  ],
+  Tools: [
+    {
+      label: "PHPStudio (CS Fixer)",
+      packages: [],
+      packagesDev: ["friendsofphp/php-cs-fixer"],
+    },
+    { label: "Monolog", packages: ["monolog/monolog"] },
+  ],
+};
+
+const RUBY = {
+  Web: [
+    { label: "Rails", packages: ["rails"] },
+    { label: "Sinatra", packages: ["sinatra"] },
+  ],
+  Testing: [{ label: "RSpec", packages: ["rspec"] }],
+  Tools: [{ label: "Rubocop", packages: ["rubocop"] }],
+};
+
+const DART = {
+  "Web/App": [{ label: "Shelf (Server)", packages: ["shelf", "shelf_router"] }],
+  State: [
+    { label: "Provider", packages: ["provider"] },
+    { label: "Riverpod", packages: ["flutter_riverpod"] },
+    { label: "Bloc", packages: ["flutter_bloc"] },
+  ],
+  Utils: [
+    { label: "Dio (HTTP)", packages: ["dio"] },
+    {
+      label: "Freezed",
+      packages: ["freezed_annotation"],
+      packagesDev: ["build_runner", "freezed"],
+    },
+  ],
+};
+
 function getCatalog(language) {
   if (language === "JavaScript/TypeScript") return JS_TS;
   if (language === "Python") return PY;
   if (language === "Rust") return RUST;
   if (language === "Go") return GO;
+  if (language === "PHP") return PHP;
+  if (language === "Ruby") return RUBY;
+  if (language === "Dart") return DART;
   return {};
 }
 

package/src/pm.js

@@ -50,6 +50,33 @@ function pmAddCommand(pm, packages, { dev = false } = {}) {
     return { program: "go", args: ["get", ...pkgs] };
   }
 
+  // PHP
+  if (pm === "composer") {
+    return {
+      program: "composer",
+      args: ["require", ...(dev ? ["--dev"] : []), ...pkgs],
+    };
+  }
+
+  // Ruby
+  if (pm === "bundle") {
+    // bundle add pkg
+    // dev dependencies often go to "development" or "test" group, but let's just do default add for now
+    // or standard "bundle add generic"
+    return {
+      program: "bundle",
+      args: ["add", ...pkgs, ...(dev ? ["--group", "development,test"] : [])],
+    };
+  }
+
+  // Dart
+  if (pm === "dart") {
+    return {
+      program: "dart",
+      args: ["pub", "add", ...(dev ? ["--dev"] : []), ...pkgs],
+    };
+  }
+
   return { program: "npm", args: ["install", ...(dev ? ["-D"] : []), ...pkgs] };
 }
 

package/src/preflight.js

@@ -0,0 +1,25 @@
+const { spawn } = require("node:child_process");
+
+function checkBinary(binary, args = ["--version"]) {
+  return new Promise((resolve) => {
+    const child = spawn(binary, args, {
+      stdio: "ignore",
+      shell: false,
+    });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+
+function checkBinaries(binaries) {
+  if (!binaries || binaries.length === 0) return [];
+  const checks = binaries.map((bin) =>
+    checkBinary(bin).then((ok) => ({ bin, ok }))
+  );
+  return Promise.all(checks);
+}
+
+module.exports = {
+  checkBinary,
+  checkBinaries,
+};

package/src/registry.js

@@ -33,6 +33,7 @@ const REGISTRY = {
     "Vite (Vanilla)": {
       id: "js.vite.vanilla",
       label: "Vite (Vanilla)",
+      check: ["npm"],
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         const pm = getPackageManager(ctx);
@@ -409,6 +410,7 @@ const REGISTRY = {
     Django: {
       id: "py.django",
       label: "Django",
+      check: ["django-admin"],
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         return [
@@ -423,23 +425,24 @@ const REGISTRY = {
     Flask: {
       id: "py.flask.basic",
       label: "Flask (basic)",
+      check: ["python3"],
       commands: (_ctx) => [
         { type: "mkdir", path: "." },
         {
           type: "writeFile",
           path: "app.py",
           content:
-            "from flask import Flask\n\napp = Flask(__name__)\n\n@app.get('/')\ndef hello():\n    return {'status': 'ok'}\n\nif __name__ == '__main__':\n    app.run(debug=True)\n",
+            "from flask import Flask\\n\\napp = Flask(__name__)\\n\\n@app.get('/')\\ndef hello():\\n    return {'status': 'ok'}\\n\\nif __name__ == '__main__':\\n    app.run(debug=True)\\n",
         },
         {
           type: "writeFile",
           path: "requirements.txt",
-          content: "flask\n",
+          content: "flask\\n",
         },
         {
           type: "writeFile",
           path: ".gitignore",
-          content: ".venv\n__pycache__\n*.pyc\n.DS_Store\n",
+          content: ".venv\\n__pycache__\\n*.pyc\\n.DS_Store\\n",
         },
       ],
       notes: "Writes app.py + requirements.txt (no pip install).",
@@ -453,23 +456,23 @@ const REGISTRY = {
           type: "writeFile",
           path: "main.py",
           content:
-            "from fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get('/')\ndef root():\n    return {'status': 'ok'}\n",
+            "from fastapi import FastAPI\\n\\napp = FastAPI()\\n\\n@app.get('/')\\ndef root():\\n    return {'status': 'ok'}\\n",
         },
         {
           type: "writeFile",
           path: "requirements.txt",
-          content: "fastapi\nuvicorn\n",
+          content: "fastapi\\nuvicorn\\n",
         },
         {
           type: "writeFile",
           path: "README.md",
           content:
-            "# FastAPI app\n\nRun:\n\n- python -m venv .venv\n- . .venv/bin/activate\n- pip install -r requirements.txt\n- uvicorn main:app --reload\n",
+            "# FastAPI app\\n\\nRun:\\n\\n- python -m venv .venv\\n- . .venv/bin/activate\\n- pip install -r requirements.txt\\n- uvicorn main:app --reload\\n",
         },
         {
           type: "writeFile",
           path: ".gitignore",
-          content: ".venv\n__pycache__\n*.pyc\n.DS_Store\n",
+          content: ".venv\\n__pycache__\\n*.pyc\\n.DS_Store\\n",
         },
       ],
       notes: "Writes files only (no pip install).",
@@ -480,18 +483,17 @@ const REGISTRY = {
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         return [
-          // Pyramid cookiecutter is common, but basic scaffold:
           { type: "mkdir", path: "." },
           {
             type: "writeFile",
             path: "requirements.txt",
-            content: "pyramid\nwaitress\n",
+            content: "pyramid\\nwaitress\\n",
           },
           {
             type: "writeFile",
             path: "app.py",
             content:
-              "from wsgiref.simple_server import make_server\nfrom pyramid.config import Configurator\nfrom pyramid.response import Response\n\ndef hello_world(request):\n    return Response('Hello World!')\n\nif __name__ == '__main__':\n    with Configurator() as config:\n        config.add_route('hello', '/')\n        config.add_view(hello_world, route_name='hello')\n        app = config.make_wsgi_app()\n    server = make_server('0.0.0.0', 6543, app)\n    server.serve_forever()\n",
+              "from wsgiref.simple_server import make_server\\nfrom pyramid.config import Configurator\\nfrom pyramid.response import Response\\n\\ndef hello_world(request):\\n    return Response('Hello World!')\\n\\nif __name__ == '__main__':\\n    with Configurator() as config:\\n        config.add_route('hello', '/')\\n        config.add_view(hello_world, route_name='hello')\\n        app = config.make_wsgi_app()\\n    server = make_server('0.0.0.0', 6543, app)\\n    server.serve_forever()\\n",
           },
         ];
       },
@@ -503,6 +505,7 @@ const REGISTRY = {
     "Cargo (bin)": {
       id: "rs.cargo.bin",
       label: "Cargo (bin)",
+      check: ["cargo"],
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         return [
@@ -517,6 +520,7 @@ const REGISTRY = {
     "Cargo (lib)": {
       id: "rs.cargo.lib",
       label: "Cargo (lib)",
+      check: ["cargo"],
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         return [
@@ -534,8 +538,6 @@ const REGISTRY = {
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         const pm = getPackageManager(ctx); // usually npm for tauri frontend
-        // Using create-tauri-app via pmExec
-        // cargo create-tauri-app is also an option but node way is common if JS frontend
         return [pmExec(pm, "create-tauri-app@latest", [projectName])];
       },
       notes: "Cross-platform desktop app",
@@ -551,8 +553,6 @@ const REGISTRY = {
             args: ["init", "--name", projectName],
             cwdFromProjectRoot: true,
           },
-          // In reality, one would use cargo-leptos or a template.
-          // Just a stub for now.
         ];
       },
       notes: "Init basic Rust project (Leptos needs template usually)",
@@ -563,6 +563,7 @@ const REGISTRY = {
     "Go module (basic)": {
       id: "go.module.basic",
       label: "Go module (basic)",
+      check: ["go"],
       commands: (ctx) => {
         const projectName = getProjectName(ctx);
         return [
@@ -591,7 +592,7 @@ const REGISTRY = {
             type: "writeFile",
             path: "main.go",
             content:
-              'package main\n\nimport "fmt"\n\nfunc main() {\n    fmt.Println("hello")\n}\n',
+              'package main\\n\\nimport "fmt"\\n\\nfunc main() {\\n    fmt.Println("hello")\\n}\\n',
           },
         ];
       },
@@ -783,8 +784,6 @@ int main() {
       id: "java.springboot.maven",
       label: "Spring Boot (Maven)",
       commands: (ctx) => {
-        // Simple archetype or just hints. Spring Init is complex.
-        // Let's use maven quickstart for now as basic.
         const projectName = getProjectName(ctx);
         return [
           {
@@ -819,11 +818,8 @@ int main() {
               "--project-name",
               projectName,
             ],
-            cwd: projectName, // This property needs to be supported in runSteps, handled via chdir logic usually?
-            // current runSteps implementation supports cwdFromProjectRoot but not arbitrary cwd change easily maybe?
-            // runSteps implementation check:
-            // It uses `cwdFromProjectRoot` or defaults to current process.cwd().
-            // Better to just run gradle init inside the folder.
+            cwd: projectName,
+            cwdFromProjectRoot: true,
           },
         ];
       },

package/src/remote.js

@@ -0,0 +1,39 @@
+const { spawn } = require("node:child_process");
+
+function gitClone(url, targetDir) {
+  return new Promise((resolve, reject) => {
+    // git clone --depth 1 url targetDir
+    const child = spawn("git", ["clone", "--depth", "1", url, targetDir], {
+      stdio: "inherit",
+      shell: false,
+    });
+
+    child.on("error", (err) => reject(err));
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`Git clone failed with code ${code}`));
+    });
+  });
+}
+
+/**
+ * Removes the .git folder from the target directory so it becomes a fresh project.
+ */
+function removeGitFolder(targetDir) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  const gitPath = path.join(targetDir, ".git");
+
+  try {
+    if (fs.existsSync(gitPath)) {
+      fs.rmSync(gitPath, { recursive: true, force: true });
+    }
+  } catch (err) {
+    // ignore
+  }
+}
+
+module.exports = {
+  gitClone,
+  removeGitFolder,
+};

package/src/settings.js

@@ -0,0 +1,45 @@
+const chalk = require("chalk");
+const { loadConfig, saveConfig, CONFIG_PATH } = require("./config");
+
+async function runConfig({ prompt }) {
+  const config = loadConfig();
+
+  console.log(chalk.bold.cyan("\nConfiguration Settings"));
+  console.log(chalk.dim(`File: ${CONFIG_PATH}\n`));
+
+  const answers = await prompt([
+    {
+      type: "list",
+      name: "packageManager",
+      message: "Default Package Manager (for JS/TS):",
+      choices: [
+        { name: "None (Always ask)", value: null },
+        new inquirerSeparator(),
+        { name: "npm", value: "npm" },
+        { name: "pnpm", value: "pnpm" },
+        { name: "yarn", value: "yarn" },
+        { name: "bun", value: "bun" },
+      ],
+      default: config.packageManager || null,
+    },
+    {
+      type: "confirm",
+      name: "learningMode",
+      message: "Enable Learning Mode by default?",
+      default: config.learningMode || false,
+    },
+  ]);
+
+  saveConfig(answers);
+  console.log(chalk.green("\n✓ Settings saved!"));
+}
+
+// Helper for pure inquirer usage if needed,
+// though index.js passes the prompt instance.
+function inquirerSeparator() {
+  // We can't easily import inquirer.Separator here without adding dependency
+  // or passing it in. Let's just use a string for now or skip it.
+  return { name: "──────────────", disabled: true };
+}
+
+module.exports = { runConfig };