create-basalt 1.0.0

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import {
+  TargetNotEmptyError,
+  createProject,
+  detectPackageManager
+} from "./chunk-RFS7HGZ6.js";
+
+// src/cli.ts
+import { spawn } from "child_process";
+import { stdin, stdout } from "process";
+import { createInterface } from "readline/promises";
+var USAGE = `Usage: npm create basalt <name> [options]
+
+Options:
+  --dir=<path>    Target directory (default: ./<name>)
+  --no-tenancy    Skip multi-tenancy
+  --no-auth       Skip authentication
+  --billing       Include subscriptions/billing
+  --ui            Scaffold a web/ frontend (React + shadcn + SDK)
+  --cli           Scaffold the 'basalt' CLI (code generators + commands)
+  --install       Install dependencies after scaffolding
+  --git           Initialize a git repository with a first commit
+  --pm=<manager>  Package manager: pnpm | npm | yarn | bun (default: auto-detect)
+  -y, --yes       Skip prompts and accept defaults
+  -h, --help      Show this help
+
+Run with no name in a terminal to be prompted interactively.
+`;
+function parseArgs(argv) {
+  const flags2 = {
+    tenancy: true,
+    auth: true,
+    billing: false,
+    ui: false,
+    cli: false,
+    install: false,
+    git: false,
+    yes: false
+  };
+  for (const token of argv) {
+    if (token === "--no-tenancy") flags2.tenancy = false;
+    else if (token === "--no-auth") flags2.auth = false;
+    else if (token === "--billing") flags2.billing = true;
+    else if (token === "--ui") flags2.ui = true;
+    else if (token === "--cli") flags2.cli = true;
+    else if (token === "--install") flags2.install = true;
+    else if (token === "--git") flags2.git = true;
+    else if (token === "-y" || token === "--yes") flags2.yes = true;
+    else if (token.startsWith("--dir=")) flags2.dir = token.slice("--dir=".length);
+    else if (token.startsWith("--pm=")) flags2.pm = token.slice("--pm=".length);
+    else if (token === "--help" || token === "-h") {
+      stdout.write(USAGE);
+      process.exit(0);
+    } else if (!token.startsWith("--") && flags2.name === void 0) flags2.name = token;
+  }
+  return flags2;
+}
+function run(command, args, cwd) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, {
+      cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+function cancel() {
+  stdout.write("\nCancelled.\n");
+  process.exit(130);
+}
+async function promptMissing(flags2) {
+  if (flags2.yes || flags2.name !== void 0 || !stdin.isTTY) return flags2;
+  const rl = createInterface({ input: stdin, output: stdout });
+  rl.on("SIGINT", cancel);
+  try {
+    const ask = async (question, fallback) => {
+      const answer = (await rl.question(`${question} `)).trim();
+      return answer || fallback;
+    };
+    const confirm = async (question, fallback) => {
+      const answer = (await rl.question(`${question} (${fallback ? "Y/n" : "y/N"}) `)).trim().toLowerCase();
+      return answer ? answer.startsWith("y") : fallback;
+    };
+    flags2.name = await ask("Project name:", "my-saas");
+    flags2.tenancy = await confirm("Multi-tenancy?", true);
+    flags2.auth = await confirm("Authentication?", true);
+    flags2.billing = await confirm("Subscriptions / billing?", false);
+    flags2.ui = await confirm("Web UI (React + shadcn)?", false);
+    flags2.cli = await confirm("'basalt' CLI (code generators)?", false);
+    flags2.install = await confirm("Install dependencies now?", false);
+    flags2.git = await confirm("Initialize a git repository?", false);
+  } catch (error) {
+    if (error.code === "ABORT_ERR") cancel();
+    throw error;
+  } finally {
+    rl.close();
+  }
+  return flags2;
+}
+var flags = await promptMissing(parseArgs(process.argv.slice(2)));
+if (!flags.name) {
+  stdout.write(USAGE);
+  process.exit(1);
+}
+var pm = flags.pm ?? detectPackageManager();
+if (flags.ui && pm !== "pnpm") {
+  console.log(`Note: --ui projects are pnpm workspaces \u2014 using pnpm instead of ${pm}.`);
+  pm = "pnpm";
+}
+try {
+  const result = await createProject({
+    name: flags.name,
+    ...flags.dir ? { dir: flags.dir } : {},
+    tenancy: flags.tenancy,
+    auth: flags.auth,
+    billing: flags.billing,
+    ui: flags.ui,
+    cli: flags.cli
+  });
+  console.log(`
+Created ${result.options.name} in ${result.dir}
+`);
+  for (const file of result.files) console.log(`  ${file}`);
+  if (flags.git) {
+    console.log("\nInitializing git repository\u2026");
+    const ok = await run("git", ["init", "-q"], result.dir) && await run("git", ["add", "-A"], result.dir) && await run(
+      "git",
+      ["commit", "-q", "-m", "Initial commit from create-basalt"],
+      result.dir
+    );
+    console.log(
+      ok ? "  git repository initialized." : "  (skipped \u2014 git unavailable or already a repo)"
+    );
+  }
+  if (flags.install) {
+    console.log(`
+Installing dependencies with ${pm}\u2026`);
+    const ok = await run(pm, ["install"], result.dir);
+    if (!ok) console.log(`  (install failed \u2014 run "${pm} install" yourself)`);
+  }
+  const steps = [`cd ${result.dir}`];
+  if (!flags.install) steps.push(`${pm} install`);
+  steps.push(`${pm} run dev${flags.ui ? "        # API on :3000" : ""}`);
+  if (flags.ui) steps.push(`pnpm --filter ${result.options.name}-web dev   # UI on :5180`);
+  console.log(`
+Next steps:
+${steps.map((s) => `  ${s}`).join("\n")}
+`);
+} catch (error) {
+  if (error instanceof TargetNotEmptyError) {
+    console.error(error.message);
+    process.exit(1);
+  }
+  throw error;
+}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+interface ProjectOptions {
+    name: string;
+    tenancy: boolean;
+    auth: boolean;
+    billing: boolean;
+    /** Scaffold a web/ frontend (React + shadcn + SDK). */
+    ui: boolean;
+    /** Scaffold the `basalt` CLI entrypoint (code generators + built-in commands). */
+    cli: boolean;
+}
+
+interface CreateProjectInput {
+    name: string;
+    /** Target directory. Default: ./<name> under cwd. */
+    dir?: string;
+    tenancy?: boolean;
+    auth?: boolean;
+    billing?: boolean;
+    /** Scaffold a web/ frontend (React + shadcn + SDK). Default: false. */
+    ui?: boolean;
+    /** Scaffold the `basalt` CLI entrypoint (code generators + commands). Default: false. */
+    cli?: boolean;
+}
+interface CreateProjectResult {
+    dir: string;
+    files: string[];
+    options: ProjectOptions;
+}
+declare class TargetNotEmptyError extends Error {
+    constructor(dir: string);
+}
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+/**
+ * Detects the package manager that invoked `npm create` / `npx`, via the
+ * `npm_config_user_agent` env var npm/pnpm/yarn/bun all set. Falls back to npm.
+ */
+declare function detectPackageManager(userAgent?: string | undefined): PackageManager;
+/** Generates a ready-to-run Basalt app. Does not install dependencies. */
+declare function createProject(input: CreateProjectInput): Promise<CreateProjectResult>;
+
+export { type CreateProjectInput, type CreateProjectResult, type PackageManager, type ProjectOptions, TargetNotEmptyError, createProject, detectPackageManager };

package/dist/index.js

@@ -0,0 +1,10 @@
+import {
+  TargetNotEmptyError,
+  createProject,
+  detectPackageManager
+} from "./chunk-RFS7HGZ6.js";
+export {
+  TargetNotEmptyError,
+  createProject,
+  detectPackageManager
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-basalt",
+  "version": "1.0.0",
+  "description": "Scaffold a production-shaped Basalt SaaS app: npm create basalt my-saas [--billing] [--ui] [--cli] [--install] [--git]",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-basalt": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0",
+    "@basaltkit/tsconfig": "^0.24.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zebedeu/basalt.git",
+    "directory": "packages/create-app"
+  },
+  "homepage": "https://github.com/Zebedeu/basalt/tree/main/packages/create-app#readme",
+  "bugs": "https://github.com/Zebedeu/basalt/issues",
+  "keywords": [
+    "basalt",
+    "typescript",
+    "saas",
+    "scaffolding",
+    "create",
+    "starter",
+    "boilerplate"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}