@clubedge/create-clubedge-app 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.3.0
+
+- Default to Starter `v0.3.0`, which adds the `clubedge.template.json` template manifest.
+- Rewrite the CLI in TypeScript, organized into argument parsing, planning, execution, and steps.
+- Bundle the pinned Starter release into the package. The default scaffold no longer downloads from GitHub or requires Git.
+- Read the Starter's `clubedge.template.json` manifest and refuse Starters with a newer template schema.
+- Add `--dry-run`, `--yes`, and `--template-dir`.
+- Remove everything written when scaffolding fails, instead of leaving a partial project.
+- Check the Node.js version before starting, and fall back to `corepack pnpm` when `pnpm` is not on the path.
+- Never copy local environment files, dependencies, or build output from a template directory, even when it sits inside another Git repository.
+
 ## 0.2.1
 
 - Publish the default Starter pin in the `clubedge` field of `package.json`. The CLI and release workflow read it from there, and the npm registry exposes it so the website always shows the Starter each CLI version scaffolds.

package/README.md

@@ -12,34 +12,34 @@ The CLI downloads a tested Starter release, names the generated project, creates
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.2.1
+create-clubedge-app v0.3.0
         |
         v
-Clubedge Starter v0.2.0
-commit db15901da90d8d8a190d158c895dfe76c172b415
+Clubedge Starter v0.3.0
+commit 60f1691920c91a5cf83e480a3ce98c3ddefdef55
 ```
 
 The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.2.1` | `clubedge-starter@v0.2.0` | The CLI's required, tested default |
+| `create-clubedge-app@0.3.0` | `clubedge-starter@v0.3.0` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 
-The `v0.2.0` tag is expected to resolve to commit
-`db15901da90d8d8a190d158c895dfe76c172b415`. The CLI verifies this before
+The `v0.3.0` tag is expected to resolve to commit
+`60f1691920c91a5cf83e480a3ce98c3ddefdef55`. The CLI verifies this before
 scaffolding with the default reference and fails rather than silently using a
 moved tag.
 
-When the Starter changes, its maintainers first publish a new versioned release, such as `v0.2.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
+When the Starter changes, its maintainers first publish a new versioned release, such as `v0.3.0`. The CLI is then updated to use that release, all generated-project checks must pass, and a new CLI version is published. This keeps Starter and CLI releases independently versioned while preserving a tested compatibility relationship.
 
 ## Requirements
 
 - Node.js 22.12 or newer.
-- pnpm 10.9.0 or newer (the generated starter uses Corepack and pnpm).
+- pnpm 10.9.0 or newer. The generated project is a pnpm workspace, so dependencies are installed with pnpm even when you start the CLI with `npx`; the CLI falls back to `corepack pnpm` when `pnpm` is not on your path.
 - Git, when using the default Git initialization.
-- Internet access to download the starter from GitHub and install dependencies.
+- Internet access to install dependencies. The default Starter release ships inside the CLI package, so GitHub is only contacted for `--ref`.
 
 ## Usage
 
@@ -73,53 +73,68 @@ pnpm dlx @clubedge/create-clubedge-app
 ```text
 Usage: pnpm dlx @clubedge/create-clubedge-app [project-directory] [options]
 
---ref <ref>            Select a starter tag, branch, or commit (default: v0.2.0)
---no-install           Skip pnpm install
---no-git               Skip Git initialization
--h, --help             Show help
--v, --version          Show the CLI version
+--ref <ref>             Download this Starter tag, branch, or commit from GitHub instead
+--template-dir <path>   Scaffold from a local Starter checkout (for Starter development)
+--dry-run               Show what would be created without writing anything
+-y, --yes               Accept defaults and never prompt (default directory: my-app)
+--no-install            Skip dependency installation
+--no-git                Skip Git initialization
+-h, --help              Show help
+-v, --version           Show the CLI version
 ```
 
-Examples:
+The target directory must be empty or not exist. The CLI never deletes or overwrites existing files, and if scaffolding fails it removes whatever it wrote, so a failed run leaves nothing behind.
 
-```sh
-pnpm dlx @clubedge/create-clubedge-app my-app --ref <starter-tag-or-commit>
-pnpm dlx @clubedge/create-clubedge-app my-app --no-install
-```
-
-The target directory must be empty or not exist. The CLI will not delete or overwrite files in a non-empty target directory. The default is the tested `v0.2.0` Starter release, so the same CLI version produces the same Starter revision. Use `--ref` to explicitly select a tag, branch, or commit.
-
-The default is the tested Starter release tag `v0.2.0`. Every generated project records its CLI version, Starter repository, exact Starter ref, and resolved Starter commit in `package.json` and `README.md`.
-
-Use `--ref` only when you intentionally want a different Starter revision:
+Every generated project records its CLI version, Starter repository, Starter ref, and Starter commit in `package.json` and `README.md`.
 
 ```sh
-# Reproduce the supported default
-pnpm dlx @clubedge/create-clubedge-app my-app
+# Preview the files and edits without writing anything
+pnpm dlx @clubedge/create-clubedge-app my-app --dry-run
+
+# Non-interactive, for scripts and CI
+pnpm dlx @clubedge/create-clubedge-app my-app --yes --no-git
 
 # Try an unreleased Starter change
 pnpm dlx @clubedge/create-clubedge-app my-app --ref main
 
 # Reproduce a specific Starter release or commit
-pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.2.0
+pnpm dlx @clubedge/create-clubedge-app my-app --ref v0.3.0
 pnpm dlx @clubedge/create-clubedge-app my-app --ref <commit-sha>
+
+# Test local Starter changes before releasing them
+pnpm dlx @clubedge/create-clubedge-app my-app --template-dir ../clubedge-starter
 ```
 
 ## How it works
 
-This CLI scaffolds the complete reference Starter. It does not yet offer selectable SaaS, dashboard, or minimal feature presets; those should be added once each preset has a distinct, maintained template. This keeps CLI output aligned with the Starter repository instead of creating a second, drifting copy of its source.
+Each CLI release bundles one Starter release. When the release is built, `scripts/bundle-template.mjs` clones the pinned Starter tag, verifies that it resolves to the pinned commit, and copies its tracked files into the package (`template/` and `template.lock.json`). Running the CLI then needs no GitHub access for the default Starter.
+
+The Starter describes itself in `clubedge.template.json`: its app directory, site config, environment files, Docker image name, and files that stay out of generated projects. The CLI refuses a Starter whose manifest schema is newer than it understands and asks you to update. Starters before v0.3.0 have no manifest and use the previous layout.
+
+The CLI first builds a plan (the files to copy and the edits to make), which `--dry-run` prints, and then applies it. The source is organized the same way:
+
+```text
+src/
+  cli/      argument parsing and terminal output
+  core/     manifest, template sources, customizations, planning, and execution
+  steps/    Git initialization and dependency installation
+  utils/    file listing and copying, processes, and naming
+```
 
 ## Development
 
 ```sh
 corepack enable
 pnpm install
-node ./bin/create.mjs --help
-pnpm check
-pnpm test
+pnpm check            # type-check sources and tests
+pnpm test             # unit and scaffolding tests
+pnpm build            # compile src/ to dist/
+node ./bin/create.mjs my-app --template-dir ../clubedge-starter --dry-run
 ```
 
-CI scaffolds a clean project from the pinned Starter release, installs its dependencies, runs linting, typechecking, unit tests, browser checks, and a production build, then starts the generated app and checks the landing page, sign-up page, dashboard, health endpoint, logo, and favicon. A scheduled, non-blocking compatibility job also checks Starter `main`.
+Without a bundled template, a local build downloads the pinned Starter release from GitHub and verifies its commit. Run `pnpm bundle-template` to bundle it, or `pnpm bundle-template --from ../clubedge-starter` to bundle a local checkout.
+
+CI packs the CLI with `npm pack`, scaffolds a clean project from the packed tarball, installs its dependencies, runs linting, typechecking, unit tests, browser checks, and a production build, then starts the generated app and checks the landing page, sign-up page, dashboard, health endpoint, logo, and favicon. A scheduled, non-blocking compatibility job also checks Starter `main`.
 
 ## Release workflow
 
@@ -128,11 +143,11 @@ CI scaffolds a clean project from the pinned Starter release, installs its depen
 1. Make and validate changes in `clubedge-starter`.
 2. Run lint, typecheck, unit tests, browser tests, and production build.
 3. Update the Starter package versions.
-4. Commit `main`, create a release tag such as `v0.2.0`, and publish the Starter release.
+4. Commit `main`, create a release tag such as `v0.3.0`, and publish the Starter release.
 
 ### CLI maintainers
 
-1. Change `defaultStarterRef` in [`bin/create.mjs`](bin/create.mjs) to the new tested Starter tag.
+1. Set `clubedge.starterRef` and `clubedge.starterCommit` in [`package.json`](package.json) to the new tested Starter tag, and bump `version`.
 2. Update the version relationship table and changelog.
 3. Generate a clean project from that exact tag.
 4. Run install, lint, typecheck, unit tests, browser tests, production build, and runtime smoke checks.

package/bin/create.mjs

@@ -1,471 +1,4 @@
 #!/usr/bin/env node
+import { main } from "../dist/index.js";
 
-import { cancel, intro, isCancel, outro, spinner, text } from "@clack/prompts";
-import { downloadTemplate } from "giget";
-import { access, cp, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
-import { spawn } from "node:child_process";
-import { basename, dirname, join, resolve } from "node:path";
-import process from "node:process";
-import { pathToFileURL } from "node:url";
-
-// package.json is the single source for the version and the tested Starter pin. It is
-// published with the package, so the npm registry exposes exactly what each release scaffolds.
-const packageManifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
-const packageVersion = packageManifest.version;
-const {
-  starterRepository,
-  starterRef: defaultStarterRef,
-  starterCommit: defaultStarterCommit,
-} = packageManifest.clubedge;
-const siteUrl = "https://clubedge.live";
-const cliUrl = "https://starter.clubedge.live";
-
-/* ------------------------------------------------------------------ */
-/* Branding: big block-letter banner                                   */
-/* ------------------------------------------------------------------ */
-
-// Each glyph is 6 rows tall. Rows are padded to a common width when rendered.
-const glyphs = {
-  C: [" ██████╗", "██╔════╝", "██║     ", "██║     ", "╚██████╗", " ╚═════╝"],
-  L: ["██╗     ", "██║     ", "██║     ", "██║     ", "███████╗", "╚══════╝"],
-  U: ["██╗   ██╗", "██║   ██║", "██║   ██║", "██║   ██║", "╚██████╔╝", " ╚═════╝ "],
-  B: ["██████╗ ", "██╔══██╗", "██████╔╝", "██╔══██╗", "██████╔╝", "╚═════╝ "],
-  E: ["███████╗", "██╔════╝", "█████╗  ", "██╔══╝  ", "███████╗", "╚══════╝"],
-  D: ["██████╗ ", "██╔══██╗", "██║  ██║", "██║  ██║", "██████╔╝", "╚═════╝ "],
-  G: [" ██████╗ ", "██╔════╝ ", "██║  ███╗", "██║   ██║", "╚██████╔╝", " ╚═════╝ "],
-  S: ["███████╗", "██╔════╝", "███████╗", "╚════██║", "███████║", "╚══════╝"],
-  T: ["████████╗", "╚══██╔══╝", "   ██║   ", "   ██║   ", "   ██║   ", "   ╚═╝   "],
-  A: [" █████╗ ", "██╔══██╗", "███████║", "██╔══██║", "██║  ██║", "╚═╝  ╚═╝"],
-  R: ["██████╗ ", "██╔══██╗", "██████╔╝", "██╔══██╗", "██║  ██║", "╚═╝  ╚═╝"],
-};
-
-function renderWord(word) {
-  const letters = [...word].map((letter) => {
-    const rows = glyphs[letter];
-    const width = Math.max(...rows.map((row) => row.length));
-    return rows.map((row) => row.padEnd(width, " "));
-  });
-  return letters[0].map((_, rowIndex) => letters.map((letter) => letter[rowIndex]).join(""));
-}
-
-const colorEnabled = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.TERM !== "dumb";
-const paint = (rgb, value) => (colorEnabled ? `\x1b[38;2;${rgb.join(";")}m${value}\x1b[0m` : value);
-const dim = (value) => (colorEnabled ? `\x1b[2m${value}\x1b[0m` : value);
-const bold = (value) => (colorEnabled ? `\x1b[1m${value}\x1b[0m` : value);
-
-// Light violet -> Clubedge brand violet, top to bottom across the banner.
-const gradientFrom = [165, 140, 255];
-const gradientTo = [91, 61, 245];
-const mix = (from, to, t) => from.map((channel, index) => Math.round(channel + (to[index] - channel) * t));
-
-function showBanner() {
-  // Stay quiet when output is piped (CI, logs, scripts).
-  if (!process.stdout.isTTY) return;
-
-  const columns = process.stdout.columns ?? 80;
-  const lines = [...renderWord("CLUBEDGE"), ...renderWord("STARTER")];
-  const widest = Math.max(...lines.map((line) => line.length));
-
-  console.log("");
-  if (columns >= widest + 2) {
-    lines.forEach((line, index) => {
-      console.log(paint(mix(gradientFrom, gradientTo, index / (lines.length - 1)), line));
-    });
-  } else {
-    // Narrow terminal: compact wordmark instead of wrapping the big letters.
-    console.log(paint(gradientTo, bold("CLUBEDGE STARTER")));
-  }
-  console.log("");
-  console.log(`  ${bold("create-clubedge-app")} ${dim(`v${packageVersion}`)}  ${dim("·")}  ${paint(gradientFrom, cliUrl)}`);
-  console.log(`  ${dim("By Clubedge")}  ${dim("·")}  ${paint(gradientFrom, siteUrl)}`);
-  console.log("");
-}
-
-/* ------------------------------------------------------------------ */
-
-function showHelp() {
-  console.log(`
-create-clubedge-app ${packageVersion}
-
-Create a Next.js project from the Clubedge Starter reference repository.
-This CLI release uses Starter ${defaultStarterRef} by default.
-Expected Starter commit: ${defaultStarterCommit}
-
-Usage:
-  pnpm dlx @clubedge/create-clubedge-app [project-directory] [options]
-
-Options:
-  --ref <ref>            Starter tag, branch, or commit to scaffold (default: ${defaultStarterRef})
-  --no-install           Skip dependency installation
-  --no-git               Skip Git repository initialization
-  -h, --help             Show this help
-  -v, --version          Show the CLI version
-
-Examples:
-  pnpm dlx @clubedge/create-clubedge-app my-app
-  pnpm dlx @clubedge/create-clubedge-app my-app --ref <starter-tag-or-commit>
-  pnpm dlx @clubedge/create-clubedge-app my-app --no-install
-
-Release model:
-  CLI ${packageVersion} -> Starter ${defaultStarterRef}
-
-Learn more:
-  CLI      ${cliUrl}
-  Clubedge ${siteUrl}
-`);
-}
-
-function parseArguments(args) {
-  const options = { install: true, git: true, ref: defaultStarterRef, projectDirectory: undefined };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const argument = args[index];
-
-    if (argument === "--help" || argument === "-h") {
-      return { ...options, help: true };
-    }
-    if (argument === "--version" || argument === "-v") {
-      return { ...options, version: true };
-    }
-    if (argument === "--no-install") {
-      options.install = false;
-      continue;
-    }
-    if (argument === "--no-git") {
-      options.git = false;
-      continue;
-    }
-    if (argument === "--ref" || argument.startsWith("--ref=")) {
-      const value = argument === "--ref" ? args[++index] : argument.slice("--ref=".length);
-      if (!value || value.startsWith("-")) {
-        throw new Error("--ref requires a branch or tag name.");
-      }
-      options.ref = value;
-      continue;
-    }
-    if (argument.startsWith("-")) {
-      throw new Error(`Unknown option: ${argument}. Run with --help to see available options.`);
-    }
-    if (options.projectDirectory) {
-      throw new Error("Only one project directory can be provided.");
-    }
-    options.projectDirectory = argument;
-  }
-
-  return options;
-}
-
-function isCancelled(value) {
-  if (isCancel(value)) {
-    cancel("Operation cancelled.");
-    process.exit(0);
-  }
-  return value;
-}
-
-function packageNameFromDirectory(directory) {
-  return (
-    basename(directory)
-      .toLowerCase()
-      .replace(/[^a-z0-9._-]+/g, "-")
-      .replace(/^[._-]+|[._-]+$/g, "") || "my-app"
-  );
-}
-
-function displayNameFromPackageName(packageName) {
-  return packageName
-    .split(/[-._]+/)
-    .filter(Boolean)
-    .map((part) => part[0].toUpperCase() + part.slice(1))
-    .join(" ");
-}
-
-async function run(command, args, cwd) {
-  await new Promise((resolvePromise, rejectPromise) => {
-    const child = spawn(command, args, {
-      cwd,
-      stdio: "inherit",
-      shell: process.platform === "win32",
-    });
-
-    child.once("error", rejectPromise);
-    child.once("exit", (code, signal) => {
-      if (code === 0) {
-        resolvePromise();
-        return;
-      }
-      rejectPromise(new Error(`${command} exited with ${signal ? `signal ${signal}` : `code ${code}`}.`));
-    });
-  });
-}
-
-async function runCapture(command, args, cwd) {
-  return await new Promise((resolvePromise, rejectPromise) => {
-    const child = spawn(command, args, {
-      cwd,
-      shell: false,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (chunk) => {
-      stdout += chunk;
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk;
-    });
-    child.once("error", rejectPromise);
-    child.once("exit", (code, signal) => {
-      if (code === 0) {
-        resolvePromise(stdout.trim());
-        return;
-      }
-      rejectPromise(
-        new Error(
-          `${command} exited with ${signal ? `signal ${signal}` : `code ${code}`}${
-            stderr.trim() ? `: ${stderr.trim()}` : "."
-          }`,
-        ),
-      );
-    });
-  });
-}
-
-async function verifyDefaultStarterReference(starterRef) {
-  if (starterRef !== defaultStarterRef) {
-    return;
-  }
-
-  const remote = `https://github.com/${starterRepository}.git`;
-  const resolvedReference = await runCapture("git", [
-    "ls-remote",
-    remote,
-    `refs/tags/${starterRef}^{}`,
-  ]);
-  const resolvedCommit = resolvedReference.split(/\s+/)[0];
-  if (resolvedCommit !== defaultStarterCommit) {
-    throw new Error(
-      `Starter tag ${starterRef} resolved to ${resolvedCommit || "no commit"}, expected ${defaultStarterCommit}.`,
-    );
-  }
-}
-
-async function ensureTargetIsSafe(directory) {
-  await mkdir(dirname(directory), { recursive: true });
-
-  try {
-    const entries = await readdir(directory);
-    if (entries.length > 0) {
-      throw new Error(`The target directory is not empty: ${directory}`);
-    }
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
-      return;
-    }
-    throw error;
-  }
-}
-
-async function fileExists(path) {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/** Starter v0.2+ keeps project identity in apps/web/src/config/site.json. */
-async function customizeSiteConfig(siteConfigPath, packageName, displayName) {
-  const siteConfig = JSON.parse(await readFile(siteConfigPath, "utf8"));
-  siteConfig.name = displayName;
-  siteConfig.shortName = displayName;
-  siteConfig.description = `${displayName} application foundation.`;
-  siteConfig.serviceId = packageName;
-  siteConfig.workspaceLabel = "Application workspace";
-  await writeFile(siteConfigPath, `${JSON.stringify(siteConfig, null, 2)}\n`);
-}
-
-/** Starter v0.1.x has no site.json, so names are replaced in known source files. */
-async function customizeLegacySources(directory, displayName) {
-  const layoutPath = join(directory, "apps", "web", "src", "app", "layout.tsx");
-  const layout = await readFile(layoutPath, "utf8");
-  const customizedLayout = layout
-    .replaceAll('"Clubedge Starter"', JSON.stringify(displayName))
-    .replace(`%s \u00b7 Clubedge Starter`, `%s \u00b7 ${displayName}`)
-    .replace(
-      "A production-minded foundation for Clubedge applications.",
-      `${displayName} application foundation.`,
-    );
-  await writeFile(layoutPath, customizedLayout);
-
-  const appFiles = [
-    join(directory, "apps", "web", "src", "app", "page.tsx"),
-    join(directory, "apps", "web", "src", "app", "dashboard", "_components", "app-sidebar.tsx"),
-    join(directory, "apps", "web", "src", "app", "dashboard", "page.tsx"),
-    join(directory, "apps", "web", "src", "app", "login", "page.tsx"),
-  ];
-  for (const appFile of appFiles) {
-    let source;
-    try {
-      source = await readFile(appFile, "utf8");
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
-        continue;
-      }
-      throw error;
-    }
-    const customizedSource = source
-      .replaceAll("Clubedge Starter", displayName)
-      .replaceAll('>Clubedge<', `>${displayName}<`)
-      .replaceAll("Starter workspace", "Application workspace");
-    await writeFile(appFile, customizedSource);
-  }
-}
-
-async function customizeProject(
-  directory,
-  packageName,
-  starterRef = defaultStarterRef,
-  starterCommit = starterRef === defaultStarterRef ? defaultStarterCommit : undefined,
-) {
-  const rootManifestPath = join(directory, "package.json");
-  const rootManifest = JSON.parse(await readFile(rootManifestPath, "utf8"));
-  rootManifest.name = packageName;
-  rootManifest.clubedge = {
-    cliVersion: packageVersion,
-    starterRepository,
-    starterRef,
-    ...(starterCommit ? { starterCommit } : {}),
-  };
-
-  for (const scriptName of ["docker:build", "docker:start"]) {
-    if (rootManifest.scripts?.[scriptName]) {
-      rootManifest.scripts[scriptName] = rootManifest.scripts[scriptName].replace(
-        /clubedge-starter/g,
-        packageName,
-      );
-    }
-  }
-  await writeFile(rootManifestPath, `${JSON.stringify(rootManifest, null, 2)}\n`);
-
-  const readmePath = join(directory, "README.md");
-  const readme = await readFile(readmePath, "utf8");
-  const displayName = displayNameFromPackageName(packageName);
-  const starterCommitLine = starterCommit ? `\n- Starter commit: \`${starterCommit}\`` : "";
-  const customizedReadme = readme
-    .replace(/^# Clubedge Starter$/m, `# ${displayName}`)
-    .replace(
-      /^# (.+)$/m,
-      `$&\n\n## Generated from\n\n- Starter repository: \`${starterRepository}\`\n- Starter ref: \`${starterRef}\`${starterCommitLine}\n- CLI version: \`${packageVersion}\``,
-    );
-  await writeFile(readmePath, customizedReadme);
-
-  const siteConfigPath = join(directory, "apps", "web", "src", "config", "site.json");
-  if (await fileExists(siteConfigPath)) {
-    await customizeSiteConfig(siteConfigPath, packageName, displayName);
-  } else {
-    await customizeLegacySources(directory, displayName);
-  }
-
-  const exampleEnvironment = join(directory, ".env.example");
-  const localEnvironment = join(directory, "apps", "web", ".env.local");
-  await cp(exampleEnvironment, localEnvironment, { errorOnExist: true });
-}
-
-async function initializeGit(directory) {
-  try {
-    await run("git", ["init", "-b", "main"], directory);
-  } catch {
-    await run("git", ["init"], directory);
-    await run("git", ["branch", "-M", "main"], directory);
-  }
-}
-
-async function createProject(options) {
-  let requestedDirectory = options.projectDirectory;
-  if (!requestedDirectory) {
-    requestedDirectory = isCancelled(
-      await text({
-        message: "Where should the new project be created?",
-        placeholder: "my-app",
-        validate(value) {
-          if (!value.trim()) return "Enter a project directory name.";
-        },
-      }),
-    );
-  }
-
-  const projectDirectory = resolve(process.cwd(), requestedDirectory);
-  if (projectDirectory === resolve(dirname(projectDirectory))) {
-    throw new Error("Choose a project subdirectory rather than a filesystem root.");
-  }
-
-  await ensureTargetIsSafe(projectDirectory);
-
-  const projectName = packageNameFromDirectory(projectDirectory);
-  await verifyDefaultStarterReference(options.ref);
-  const source = `gh:${starterRepository}#${options.ref}`;
-  const downloadSpinner = spinner();
-  downloadSpinner.start(`Downloading Clubedge Starter (${options.ref})`);
-  try {
-    await downloadTemplate(source, { dir: projectDirectory, force: true });
-    await customizeProject(projectDirectory, projectName, options.ref);
-    downloadSpinner.stop("Starter files downloaded and configured");
-  } catch (error) {
-    downloadSpinner.stop("Project scaffold failed");
-    throw error;
-  }
-
-  if (options.git) {
-    console.log("\nInitializing Git...");
-    await initializeGit(projectDirectory);
-    console.log("Git repository initialized on main");
-  }
-
-  if (options.install) {
-    console.log("\nInstalling dependencies with pnpm...\n");
-    try {
-      await run("pnpm", ["install"], projectDirectory);
-      console.log("\nDependencies installed");
-    } catch (error) {
-      console.error("\nProject created; dependency installation did not complete.");
-      console.error(error instanceof Error ? error.message : error);
-      console.error("Install pnpm with Corepack, then run `pnpm install` in the new project.");
-    }
-  }
-
-  const relativeDirectory = process.cwd() === projectDirectory ? "." : requestedDirectory;
-  outro(
-    `Created ${projectName}.\n\nNext steps:\n  cd ${relativeDirectory}\n  pnpm dev\n\nSee SETUP.md for database and provider configuration.\n\nDocs: ${cliUrl}\nClubedge: ${siteUrl}`,
-  );
-}
-
-async function main() {
-  try {
-    const options = parseArguments(process.argv.slice(2));
-    if (options.version) {
-      console.log(packageVersion);
-      return;
-    }
-
-    showBanner();
-
-    if (options.help) {
-      showHelp();
-      return;
-    }
-
-    intro("Create a project with Clubedge Starter");
-    await createProject(options);
-  } catch (error) {
-    console.error(`\n${error instanceof Error ? error.message : String(error)}`);
-    process.exitCode = 1;
-  }
-}
-
-export { customizeProject, displayNameFromPackageName, packageNameFromDirectory };
-
-if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
-  await main();
-}
+await main();