create-softeneers-app 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# create-softeneers-app
+
+The Softeneers Framework project generator. Run it to scaffold a new project
+from one of the bundled templates:
+
+```bash
+npx create-softeneers-app@latest my-app
+```
+
+## Status
+
+**Implemented** for the `next-fullstack` template: interactive wizard, copy +
+transform, `git init`, dependency install, and next-step output. Other templates
+are listed in the wizard as "coming soon".
+
+```bash
+npx create-softeneers-app@latest my-app                 # interactive
+npx create-softeneers-app@latest my-app --yes --pm npm  # non-interactive
+```
+
+Flags: `--template <slug>`, `--yes`/`-y`, `--no-install`, `--no-git`,
+`--pm <pnpm|npm|yarn>`, `--help`, `--version`. See
+[`../../docs/CLI-SPEC.md`](../../docs/CLI-SPEC.md) for the full contract.
+
+## Local development
+
+```bash
+npm run build -w create-softeneers-app    # tsc + bundle templates → dist/ + templates/
+node apps/cli/dist/index.js my-app --yes  # run the built CLI
+npm run dev  -w create-softeneers-app -- my-app   # run from source via tsx
+```

package/dist/args.js

@@ -0,0 +1,96 @@
+/** Minimal, dependency-free argv parsing for create-softeneers-app. */
+const PMS = ["pnpm", "npm", "yarn"];
+/**
+ * Detect the package manager the user invoked us with (via `npm_config_user_agent`,
+ * which npm/pnpm/yarn all set). Defaults to npm — the framework is npm-first and
+ * npm is always present with Node.
+ */
+export function detectPackageManager() {
+    const ua = process.env.npm_config_user_agent ?? "";
+    const name = ua.split("/")[0];
+    if (name === "pnpm" || name === "yarn")
+        return name;
+    return "npm";
+}
+export function parseArgs(argv) {
+    const opts = {
+        yes: false,
+        install: true,
+        git: true,
+        packageManager: detectPackageManager(),
+        help: false,
+        version: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        switch (arg) {
+            case "--yes":
+            case "-y":
+                opts.yes = true;
+                break;
+            case "--no-install":
+                opts.install = false;
+                break;
+            case "--no-git":
+                opts.git = false;
+                break;
+            case "--help":
+            case "-h":
+                opts.help = true;
+                break;
+            case "--version":
+            case "-v":
+                opts.version = true;
+                break;
+            case "--template":
+            case "-t":
+                opts.template = argv[++i];
+                break;
+            case "--pm": {
+                const pm = argv[++i];
+                if (!PMS.includes(pm)) {
+                    throw new CliError(`--pm must be one of: ${PMS.join(", ")} (got "${pm}")`);
+                }
+                opts.packageManager = pm;
+                break;
+            }
+            default:
+                if (arg.startsWith("-")) {
+                    throw new CliError(`Unknown option: ${arg}`);
+                }
+                if (opts.targetDir === undefined) {
+                    opts.targetDir = arg;
+                }
+                else {
+                    throw new CliError(`Unexpected argument: ${arg}`);
+                }
+        }
+    }
+    return opts;
+}
+/** A user-facing error (bad args, dir exists). Exit code 1. */
+export class CliError extends Error {
+}
+export const HELP_TEXT = `
+create-softeneers-app — scaffold a Softeneers Framework project
+
+Usage:
+  npx create-softeneers-app@latest [directory|.] [options]
+
+Options:
+  -t, --template <name>   Template to use (default: prompt; only "next-fullstack" for now)
+  -y, --yes               Accept defaults, no prompts
+      --no-install        Don't install dependencies
+      --no-git            Don't run "git init"
+      --pm <npm|pnpm|yarn> Package manager (default: auto-detected, else npm)
+  -h, --help              Show this help
+  -v, --version           Show version
+
+Examples:
+  npx create-softeneers-app@latest my-app      # scaffold into ./my-app
+  npx create-softeneers-app@latest .           # scaffold into the current directory
+  npm create softeneers-app@latest my-app -- --yes
+`;
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAqBvE,MAAM,GAAG,GAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAe;QACvB,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,IAAI;QACT,cAAc,EAAE,oBAAoB,EAAE;QACtC,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,OAAO,CAAC;YACb,KAAK,IAAI;gBACP,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;gBACjB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,YAAY,CAAC;YAClB,KAAK,IAAI;gBACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAoB,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,QAAQ,CAAC,wBAAwB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC7E,CAAC;gBACD,IAAI,CAAC,cAAc,GAAG,EAAoB,CAAC;gBAC3C,MAAM;YACR,CAAC;YACD;gBACE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,IAAI,QAAQ,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;gBAC/C,CAAC;gBACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACjC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,QAAQ,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;gBACpD,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,OAAO,QAAS,SAAQ,KAAK;CAAG;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC"}

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { basename, resolve } from "node:path";
+import { intro, log, note, outro, spinner } from "@clack/prompts";
+import { CliError, HELP_TEXT, parseArgs } from "./args.js";
+import { promptProjectName, promptTemplate } from "./prompts.js";
+import { assertTargetUsable, copyTemplate, gitInit, installDeps, toPackageName, transform, } from "./scaffold.js";
+import { DEFAULT_TEMPLATE, findTemplate, resolveTemplateDir } from "./templates.js";
+function version() {
+    try {
+        const require = createRequire(import.meta.url);
+        return require("../package.json").version;
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (opts.help) {
+        console.log(HELP_TEXT);
+        return;
+    }
+    if (opts.version) {
+        console.log(version());
+        return;
+    }
+    intro("create-softeneers-app");
+    // 1. Project name + target directory. "." (or any path resolving to cwd) scaffolds in place.
+    const rawTarget = opts.targetDir ?? (opts.yes ? "my-app" : await promptProjectName());
+    const targetDir = resolve(process.cwd(), rawTarget);
+    const inCurrentDir = targetDir === process.cwd();
+    const projectName = basename(targetDir);
+    // 2. Template.
+    const slug = opts.template ?? (opts.yes ? DEFAULT_TEMPLATE : await promptTemplate());
+    const template = findTemplate(slug);
+    if (!template) {
+        throw new CliError(`Unknown template "${slug}".`);
+    }
+    if (!template.available) {
+        throw new CliError(`Template "${slug}" is not available yet. Try "next-fullstack".`);
+    }
+    const templateDir = resolveTemplateDir(slug);
+    if (!templateDir) {
+        throw new CliError(`Could not locate template files for "${slug}".`);
+    }
+    // 3. Generate.
+    assertTargetUsable(targetDir);
+    const pkgName = toPackageName(targetDir);
+    const s = spinner();
+    s.start(`Creating ${projectName}`);
+    copyTemplate(templateDir, targetDir);
+    transform(targetDir, projectName, pkgName, opts.packageManager);
+    s.stop(`Created ${projectName}`);
+    if (opts.git) {
+        if (gitInit(targetDir))
+            log.success("Initialized a git repository.");
+        else
+            log.warn("Skipped git init (git not available).");
+    }
+    if (opts.install) {
+        const inst = spinner();
+        inst.start(`Installing dependencies with ${opts.packageManager}`);
+        if (installDeps(targetDir, opts.packageManager)) {
+            inst.stop("Installed dependencies.");
+        }
+        else {
+            inst.stop("Dependency install failed — run it manually.");
+        }
+    }
+    // 4. Next steps.
+    const pm = opts.packageManager;
+    const steps = [
+        ...(inCurrentDir ? [] : [`cd ${rawTarget}`]),
+        ...(opts.install ? [] : [`${pm} install`]),
+        "docker compose up -d        # start MySQL",
+        `${pm} run db:migrate`,
+        `${pm} run db:seed`,
+        `${pm} run dev`,
+    ].join("\n");
+    note(steps, "Next steps");
+    outro("Web: http://localhost:3000   API: http://localhost:4000");
+}
+main().catch((err) => {
+    if (err instanceof CliError) {
+        console.error(`\nError: ${err.message}`);
+        process.exitCode = 1;
+    }
+    else {
+        console.error("\nUnexpected error:", err);
+        process.exitCode = 2;
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts.js

@@ -0,0 +1,31 @@
+import { cancel, isCancel, select, text } from "@clack/prompts";
+import { DEFAULT_TEMPLATE, TEMPLATES } from "./templates.js";
+function bail(value) {
+    if (isCancel(value)) {
+        cancel("Cancelled.");
+        process.exit(0);
+    }
+    return value;
+}
+export async function promptProjectName(initial) {
+    const value = await text({
+        message: "Project name:",
+        placeholder: "my-app",
+        initialValue: initial,
+        validate: (v) => (v.trim().length === 0 ? "Please enter a project name." : undefined),
+    });
+    return bail(value).trim();
+}
+export async function promptTemplate() {
+    const value = await select({
+        message: "What type of project do you want?",
+        initialValue: DEFAULT_TEMPLATE,
+        options: TEMPLATES.map((t) => ({
+            value: t.slug,
+            label: t.label,
+            hint: t.available ? t.hint : `${t.hint} — not available yet`,
+        })),
+    });
+    return bail(value);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE7D,SAAS,IAAI,CAAI,KAAiB;IAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,YAAY,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAgB;IACtD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC;QACvB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,OAAO;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,SAAS,CAAC;KACtF,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;QACzB,OAAO,EAAE,mCAAmC;QAC5C,YAAY,EAAE,gBAAgB;QAC9B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,KAAK,EAAE,CAAC,CAAC,IAAI;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,sBAAsB;SAC7D,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/scaffold.js

@@ -0,0 +1,130 @@
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { CliError } from "./args.js";
+/** Names excluded when copying a template (docs/CLI-SPEC.md → copy exclusions). */
+const EXCLUDED_NAMES = new Set([
+    "node_modules",
+    ".next",
+    "out",
+    "build",
+    "dist",
+    ".turbo",
+    ".git",
+    ".DS_Store",
+    "package-lock.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+]);
+function isExcluded(name) {
+    if (EXCLUDED_NAMES.has(name))
+        return true;
+    if (name.endsWith(".log"))
+        return true;
+    // Drop real env files but keep the examples.
+    if (name === ".env" || (name.startsWith(".env.") && name !== ".env.example")) {
+        return true;
+    }
+    return false;
+}
+/** npm package name from a directory name: lowercase, spaces/invalid → dashes. */
+export function toPackageName(dir) {
+    return (basename(dir)
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[-.]+|[-.]+$/g, "") || "app");
+}
+/** Entries allowed to pre-exist in the target (e.g. when scaffolding into "."). */
+const ALLOWED_EXISTING = new Set([".git", ".DS_Store"]);
+export function assertTargetUsable(targetDir) {
+    if (!existsSync(targetDir))
+        return;
+    const blocking = readdirSync(targetDir).filter((name) => !ALLOWED_EXISTING.has(name));
+    if (blocking.length > 0) {
+        throw new CliError(`Target directory "${targetDir}" is not empty.`);
+    }
+}
+/** Copy the template into the target, applying exclusions. */
+export function copyTemplate(templateDir, targetDir) {
+    mkdirSync(targetDir, { recursive: true });
+    cpSync(templateDir, targetDir, {
+        recursive: true,
+        filter: (src) => !isExcluded(basename(src)),
+    });
+}
+const PM_FALLBACK_VERSION = {
+    npm: "10.9.0",
+    pnpm: "9.12.0",
+    yarn: "4.5.0",
+};
+/** Best-effort actual version of the chosen PM, else a sane pinned fallback. */
+function detectPmVersion(pm) {
+    const res = spawnSync(pm, ["--version"], {
+        encoding: "utf8",
+        shell: process.platform === "win32",
+    });
+    const v = res.status === 0 ? String(res.stdout).trim() : "";
+    return /^\d+\.\d+\.\d+/.test(v) ? v : PM_FALLBACK_VERSION[pm];
+}
+/**
+ * Rewrite the root package.json: set "name" and pin "packageManager" to the
+ * chosen PM. The packageManager field is required by Turborepo to resolve the
+ * workspace (the template ships both npm `workspaces` and pnpm-workspace.yaml).
+ */
+function rewriteRootPackage(targetDir, pkgName, pm) {
+    const pkgPath = join(targetDir, "package.json");
+    if (!existsSync(pkgPath))
+        return;
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    pkg.name = pkgName;
+    pkg.packageManager = `${pm}@${detectPmVersion(pm)}`;
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+/** For every .env.example in the tree, create a sibling .env if missing. */
+function generateEnvFiles(targetDir) {
+    const stack = [targetDir];
+    while (stack.length) {
+        const dir = stack.pop();
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name === "node_modules")
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(full);
+            }
+            else if (entry.name === ".env.example") {
+                const envPath = join(dir, ".env");
+                if (!existsSync(envPath)) {
+                    writeFileSync(envPath, readFileSync(full, "utf8"));
+                }
+            }
+        }
+    }
+}
+/** Replace {{PROJECT_NAME}} placeholders in the README. */
+function substitutePlaceholders(targetDir, projectName) {
+    const readme = join(targetDir, "README.md");
+    if (!existsSync(readme))
+        return;
+    const next = readFileSync(readme, "utf8").replaceAll("{{PROJECT_NAME}}", projectName);
+    writeFileSync(readme, next);
+}
+export function transform(targetDir, projectName, pkgName, pm) {
+    rewriteRootPackage(targetDir, pkgName, pm);
+    generateEnvFiles(targetDir);
+    substitutePlaceholders(targetDir, projectName);
+}
+function run(cmd, args, cwd) {
+    const res = spawnSync(cmd, args, { cwd, stdio: "ignore", shell: process.platform === "win32" });
+    return res.status === 0;
+}
+export function gitInit(targetDir) {
+    if (!run("git", ["init", "-q"], targetDir))
+        return false;
+    run("git", ["add", "-A"], targetDir);
+    return true;
+}
+export function installDeps(targetDir, pm) {
+    return run(pm, ["install"], targetDir);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAuB,MAAM,WAAW,CAAC;AAE1D,mFAAmF;AACnF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,cAAc;IACd,OAAO;IACP,KAAK;IACL,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;IACN,WAAW;IACX,mBAAmB;IACnB,gBAAgB;IAChB,WAAW;CACZ,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,6CAA6C;IAC7C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,cAAc,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,CACL,QAAQ,CAAC,GAAG,CAAC;SACV,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,KAAK,CAC1C,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,qBAAqB,SAAS,iBAAiB,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAiB;IACjE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;QAC7B,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,mBAAmB,GAAmC;IAC1D,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,gFAAgF;AAChF,SAAS,eAAe,CAAC,EAAkB;IACzC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE;QACvC,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;KACpC,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,OAAe,EAAE,EAAkB;IAChF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAA4B,CAAC;IACjF,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC;IACnB,GAAG,CAAC,cAAc,GAAG,GAAG,EAAE,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;IACpD,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,4EAA4E;AAC5E,SAAS,gBAAgB,CAAC,SAAiB;IACzC,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAS;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAClC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzB,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,SAAS,sBAAsB,CAAC,SAAiB,EAAE,WAAmB;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IACtF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,WAAmB,EACnB,OAAe,EACf,EAAkB;IAElB,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5B,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IACnD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAChG,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,SAAiB;IACvC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,EAAkB;IAC/D,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/templates.js

@@ -0,0 +1,40 @@
+import { existsSync, statSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * The template registry. Only `next-fullstack` is generatable today; the rest
+ * are advertised so the wizard reflects the intended menu (docs/CLI-SPEC.md)
+ * and light up as they land.
+ */
+export const TEMPLATES = [
+    {
+        slug: "next-fullstack",
+        label: "Fullstack (Next.js + Express + Sequelize + MySQL)",
+        hint: "web + server monorepo, Docker MySQL",
+        available: true,
+    },
+    { slug: "tanstack-start", label: "TanStack Start", hint: "coming soon", available: false },
+    { slug: "hono-api", label: "Hono API only", hint: "coming soon", available: false },
+    { slug: "express-api", label: "Express API only", hint: "coming soon", available: false },
+    { slug: "minimal", label: "Minimal", hint: "coming soon", available: false },
+];
+export const DEFAULT_TEMPLATE = "next-fullstack";
+export function findTemplate(slug) {
+    return TEMPLATES.find((t) => t.slug === slug);
+}
+/**
+ * Resolve the on-disk directory for a template, in priority order:
+ *   1. bundled with the package  (<pkg>/templates/<slug>)  — published layout
+ *   2. the monorepo templates dir (<pkg>/../../templates/<slug>) — local dev
+ * Returns the first that exists, or undefined.
+ */
+export function resolveTemplateDir(slug) {
+    const here = dirname(fileURLToPath(import.meta.url)); // src/ (tsx) or dist/ (built)
+    const pkgRoot = resolve(here, ".."); // apps/cli
+    const candidates = [
+        resolve(pkgRoot, "templates", slug),
+        resolve(pkgRoot, "..", "..", "templates", slug),
+    ];
+    return candidates.find((dir) => existsSync(dir) && statSync(dir).isDirectory());
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,mDAAmD;QAC1D,IAAI,EAAE,qCAAqC;QAC3C,SAAS,EAAE,IAAI;KAChB;IACD,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE;IAC1F,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE;IACnF,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE;IACzF,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE;CAC7E,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B;IACpF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW;IAChD,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC;QACnC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC;KAChD,CAAC;IACF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "create-softeneers-app",
+  "version": "0.1.0",
+  "description": "Scaffold a new Softeneers Framework project from a template.",
+  "type": "module",
+  "bin": {
+    "create-softeneers-app": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-templates.mjs",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/*.test.mjs",
+    "clean": "rm -rf dist templates",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "softeneers",
+    "scaffold",
+    "generator",
+    "create-app"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.7.0"
+  },
+  "author": "Tudor Damian",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tunder007/monolith_demo.git",
+    "directory": "apps/cli"
+  },
+  "homepage": "https://github.com/tunder007/monolith_demo#readme"
+}

package/templates/next-fullstack/.env.example

@@ -0,0 +1,18 @@
+# Root environment for the generated project.
+# Copied to .env by create-softeneers-app. Per-app values also live in
+# apps/server/.env.example. Keep these in sync with docker-compose.yml.
+
+# --- Web (apps/web) ---
+# Base URL the browser app uses to reach the API.
+NEXT_PUBLIC_API_URL=http://localhost:4000
+
+# --- Server (apps/server) ---
+PORT=4000
+FRONTEND_URL=http://localhost:3000
+
+# --- Database (must match docker-compose.yml) ---
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_NAME=app_dev
+DB_USER=root
+DB_PASSWORD=

package/templates/next-fullstack/README.md

@@ -0,0 +1,54 @@
+# {{PROJECT_NAME}}
+
+A fullstack app generated with
+[`create-softeneers-app`](https://www.npmjs.com/package/create-softeneers-app):
+**Next.js** web client + **Express / Sequelize / MySQL** JSON API, in a
+Turborepo monorepo that works with **npm** or **pnpm**.
+
+> `{{PROJECT_NAME}}` is replaced with your project name at generation time.
+
+## Layout
+
+```
+apps/
+  web/      Next.js 16 + React 19 + Tailwind v4   → http://localhost:3000
+  server/   Express 5 + Sequelize 6 + mysql2      → http://localhost:4000
+docker-compose.yml   MySQL 8 for local development
+```
+
+## Getting started
+
+```bash
+# 1. Install dependencies (npm shown; pnpm works too)
+npm install
+
+# 2. Configure environment
+cp .env.example .env
+cp apps/server/.env.example apps/server/.env
+
+# 3. Start the database
+docker compose up -d
+
+# 4. Run migrations + seed
+npm run db:migrate
+npm run db:seed
+
+# 5. Start web + server together
+npm run dev
+```
+
+- Web app: <http://localhost:3000>
+- API health check: <http://localhost:4000/health>
+- Cars API: <http://localhost:4000/api/cars>
+
+## Scripts
+
+All scripts run through Turborepo, so they behave identically under npm or pnpm.
+
+| Command              | Description                        |
+| -------------------- | ---------------------------------- |
+| `npm run dev`        | Run web + server                   |
+| `npm run build`      | Build all apps                     |
+| `npm run db:migrate` | Run Sequelize migrations (server)  |
+| `npm run db:seed`    | Seed the database (server)         |
+| `npm run db:reset`   | Undo, re-migrate and re-seed       |

package/templates/next-fullstack/apps/server/.env.example

@@ -0,0 +1,8 @@
+PORT=4000
+FRONTEND_URL=http://localhost:3000
+
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_NAME=monolith_demo_dev
+DB_USER=root
+DB_PASSWORD=

package/templates/next-fullstack/apps/server/README.md

@@ -0,0 +1,64 @@
+# Backend Quick Start
+
+Backend-ul este un API Express + Sequelize + MySQL pentru CRUD pe `cars`.
+
+## 1) Instaleaza dependintele
+
+```bash
+cd backend
+npm install
+```
+
+## 2) Creeaza baza de date MySQL (generic CLI)
+
+Inlocuieste placeholder-ele cu valorile tale:
+
+```bash
+mysql -h <DB_HOST> -P <DB_PORT> -u <DB_USER> -p -e "CREATE DATABASE IF NOT EXISTS monolith_demo_dev;"
+```
+
+Exemplu uzual local:
+
+```bash
+mysql -h 127.0.0.1 -P 3306 -u root -p -e "CREATE DATABASE IF NOT EXISTS monolith_demo_dev;"
+```
+
+## 3) Configureaza `.env` din `.env.example`
+
+```bash
+cp .env.example .env
+```
+
+Editeaza apoi `./.env` cu datele tale reale de conexiune MySQL.
+
+## 4) Ruleaza migration + seed
+
+```bash
+npm run db:migrate
+npm run db:seed
+```
+
+Migration creeaza tabela `cars`, seed adauga date demo.
+
+## 5) Porneste serverul backend
+
+```bash
+npm run dev
+```
+
+Serverul ruleaza pe `http://localhost:4000`.
+
+## 6) Verifica rapid API-ul
+
+```bash
+curl http://localhost:4000/health
+curl http://localhost:4000/api/cars
+```
+
+## Comenzi utile
+
+```bash
+npm run db:reset
+npm run build
+npm run start
+```