create-disposabl-app 0.0.2 → 0.0.4

package/README.md

@@ -1,11 +1,34 @@
 # Create Disposabl app
 
-Requires [Bun](https://bun.com) 1.4.4 or later.
+```sh
+bun create disposabl-app@latest
+# or
+npx create-disposabl-app@latest my-app
+```
+
+Choose platforms and optional features. Web is required; Docs is optional. The CLI installs dependencies with Bun, then prints the commands to start your app.
+
+Options: `-h` / `--help`, `-v` / `--version`, `-y` / `--yes` for defaults, `--docs`, and `--skip-install`.
+
+The CLI uses Node.js 22.12 or later. Bun-only environments can use `bunx --bun create-disposabl-app@latest`. The generated app uses Bun, ESLint, and `bun fmt`. Docs, when selected, is available at `/docs`.
+
+## Development
+
+The app lives in `cli/templates/default/`. Everything outside that directory is CLI or repository tooling. `bun run build` bundles the template; generated apps receive no publishing scripts or workflows.
 
 ```sh
-bun create disposabl-app@latest my-app
-cd my-app
+bun install
+bun fmt
+bun run lint
+bun run typecheck
+bun run build
 bun run dev
 ```
 
-Downloads the starter from [disposabl-dev/create-disposabl-app](https://github.com/disposabl-dev/create-disposabl-app), excludes the CLI and npm publishing workflow, and installs dependencies with Bun. Existing folders are never overwritten.
+## Releases
+
+Push or merge to `main` to publish. Stable versions increment the patch automatically. Set a higher stable version in `cli/package.json` for a minor or major release. Set an explicit future version such as `0.1.0-beta.1` for a beta, incrementing it manually for each beta publication. Remove the suffix and set the intended stable version when ready.
+
+The workflow records the actual version in a release commit, publishes to npm `latest` or `beta`, confirms availability, then creates the matching Git tag and GitHub Release. Betas become GitHub prereleases. Reruns reuse the recorded version and repair incomplete releases. No PR builds are published.
+
+First publication only: build, run `npm login`, then `npm publish` inside `cli/` with version `0.0.1`. Later releases use npm trusted publishing without an npm token in GitHub.

package/dist/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+// cli/index.ts
+import { spawn, spawnSync } from "node:child_process";
+import {
+  cp,
+  mkdir,
+  readdir,
+  readFile,
+  rename,
+  writeFile
+} from "node:fs/promises";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import prompts from "prompts";
+// cli/package.json
+var version = "0.0.4";
+
+// cli/index.ts
+var program = new Command("create-disposabl-app").description("Create a Disposabl app from the bundled starter.").version(version, "-v, --version").argument("[appname]", "Name of the new app").option("-y, --yes", "Use defaults without asking questions").option("--docs", "Include Docs").option("--skip-install", "Skip bun install").helpOption("-h, --help").parse();
+var validName = (name) => /^[a-z0-9][a-z0-9._-]*$/.test(name) && name.length <= 214 && !["node_modules", "favicon.ico"].includes(name);
+try {
+  const options = program.opts();
+  let name = program.args[0];
+  let docs = Boolean(options.docs);
+  if (process.stdin.isTTY && !options.yes) {
+    const answers = await prompts([
+      {
+        type: name ? null : "text",
+        name: "name",
+        message: "What is your project named?",
+        initial: "my-app",
+        validate: (value) => validName(value) || "Use a lowercase app name without spaces."
+      },
+      {
+        type: "multiselect",
+        name: "platforms",
+        message: "Which platforms?",
+        choices: [
+          {
+            title: "Web (required)",
+            value: "web",
+            selected: true,
+            disabled: true
+          }
+        ],
+        min: 1,
+        warn: "Web is required.",
+        onRender() {
+          for (const choice of this.value) {
+            if (choice.value === "web")
+              choice.selected = true;
+          }
+        },
+        hint: "Web is required. Press Enter to continue."
+      },
+      {
+        type: options.docs ? null : "multiselect",
+        name: "features",
+        message: "Which features?",
+        choices: [{ title: "Docs", value: "docs" }],
+        hint: "Space to select. Enter to continue without optional features."
+      }
+    ], {
+      onCancel: () => {
+        console.log("Cancelled.");
+        process.exit(0);
+      }
+    });
+    name ??= answers.name;
+    docs ||= answers.features?.includes("docs") ?? false;
+  }
+  if (!name || !validName(name))
+    throw new Error("Provide a lowercase app name, or run with --help.");
+  if (!options.skipInstall && spawnSync("bun", ["--version"]).status !== 0)
+    throw new Error("Install Bun from https://bun.com first.");
+  const dir = resolve(name);
+  await mkdir(dir);
+  console.log(`
+Creating a new Disposabl app in ${dir}.
+
+Using bun.
+
+Platform: Web
+Features: ${docs ? "Docs" : "None"}
+`);
+  const template = fileURLToPath(new URL("./templates/default", import.meta.url));
+  for (const file of await readdir(template)) {
+    if (file === "docs" && !docs)
+      continue;
+    await cp(resolve(template, file), resolve(dir, file), {
+      recursive: true,
+      force: false,
+      errorOnExist: true
+    });
+  }
+  await rename(resolve(dir, "gitignore"), resolve(dir, ".gitignore"));
+  const manifestPath = resolve(dir, "package.json");
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+  manifest.name = name;
+  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  if (!options.skipInstall) {
+    await new Promise((done, reject) => {
+      const child = spawn("bun", ["install"], {
+        cwd: dir,
+        stdio: "inherit",
+        env: { ...process.env, NODE_ENV: "development" }
+      });
+      child.once("error", reject);
+      child.once("close", (code) => code === 0 ? done() : reject(new Error(`Run bun install inside ${name} to retry.`)));
+    });
+  }
+  console.log(`
+Success! Created ${name} at ${dir}
+
+Get started:
+
+  cd ${name}
+${options.skipInstall ? `  bun install
+` : ""}  bun run dev
+`);
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+}

package/dist/templates/default/README.md

@@ -0,0 +1,12 @@
+# Disposabl app
+
+Start the development server with [Bun](https://bun.com):
+
+```sh
+bun run dev
+```
+
+Open http://localhost:3000. Edit `index.ts` to build your app.
+
+Run `bun run lint` for ESLint and `bun fmt` for formatting.
+If you selected Docs, open http://localhost:3000/docs and edit `docs/index.html`.

package/dist/templates/default/docs/index.html

@@ -0,0 +1,8 @@
+<!doctype html>
+<html lang="en">
+  <meta charset="utf-8" />
+  <title>Documentation</title>
+  <h1>Documentation</h1>
+  <p>Edit docs/index.html to write your app's documentation.</p>
+  <a href="/">Back to your app</a>
+</html>

package/dist/templates/default/eslint.config.js

@@ -0,0 +1,18 @@
+import js from "@eslint/js";
+import ts from "typescript-eslint";
+
+export default ts.config(
+  { ignores: ["**/dist/**", "**/node_modules/**"] },
+  js.configs.recommended,
+  ts.configs.recommended,
+  {
+    languageOptions: {
+      globals: {
+        Bun: "readonly",
+        process: "readonly",
+        console: "readonly",
+        URL: "readonly",
+      },
+    },
+  },
+);

package/dist/templates/default/gitignore

@@ -0,0 +1,4 @@
+node_modules/
+.env
+.env.*
+!.env.example

package/dist/templates/default/index.ts

@@ -0,0 +1,14 @@
+const server = Bun.serve({
+  port: process.env.PORT ?? 3000,
+  async fetch(request) {
+    if (new URL(request.url).pathname === "/docs") {
+      const page = Bun.file(new URL("./docs/index.html", import.meta.url));
+      return (await page.exists())
+        ? new Response(page)
+        : new Response("Not found", { status: 404 });
+    }
+    return new Response("Your Disposabl app is ready.\n");
+  },
+});
+
+console.log(`Your app is running at ${server.url}`);

package/dist/templates/default/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "disposabl-app",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun --hot index.ts",
+    "lint": "eslint ."
+  },
+  "devDependencies": {
+    "eslint": "10.13.0",
+    "@eslint/js": "10.0.1",
+    "typescript-eslint": "8.72.1",
+    "typescript": "6.0.3",
+    "@types/bun": "1.4.4"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-disposabl-app",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Create a Disposabl app with Bun",
   "type": "module",
   "license": "MIT",
@@ -10,22 +10,23 @@
     "directory": "cli"
   },
   "bin": {
-    "create-disposabl-app": "index.js"
+    "create-disposabl-app": "dist/index.js"
   },
   "files": [
-    "index.js",
+    "dist",
     "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.4.4"
+    "node": ">=22.12.0"
   },
   "scripts": {
-    "test": "bun test"
-  },
-  "dependencies": {
-    "giget": "3.3.1"
+    "build": "bun build.ts"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "commander": "15.0.0",
+    "prompts": "2.4.2"
   }
 }

package/index.js

@@ -1,56 +0,0 @@
-#!/usr/bin/env bun
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { resolve } from "node:path";
-import { downloadTemplate } from "giget";
-
-export async function createApp(name, source = "gh:disposabl-dev/create-disposabl-app#main") {
-  if (!name || !/^[a-z0-9][a-z0-9._-]*$/.test(name) || name.length > 214) {
-    throw new Error("Choose a folder name using lowercase letters, numbers, dots, underscores, or hyphens.");
-  }
-
-  const dir = resolve(name);
-  // Claim the destination before downloading. Never overwrite an existing path.
-  await mkdir(dir);
-  console.log(`Creating ${name}...`);
-  await downloadTemplate(source, {
-    dir,
-    force: true,
-    ignore: (path) => path === "cli" || path.startsWith("cli/") || path === ".github/workflows/publish.yml",
-  });
-
-  const manifestPath = resolve(dir, "package.json");
-  const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
-  manifest.name = name;
-  manifest.private = true;
-  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
-  await writeFile(resolve(dir, "README.md"), `# ${name}\n\nStart the development server:\n\n\`\`\`sh\nbun run dev\n\`\`\`\n`);
-
-  const install = Bun.spawn([process.execPath, "install"], {
-    cwd: dir,
-    stdin: "inherit",
-    stdout: "inherit",
-    stderr: "inherit",
-  });
-  if (await install.exited !== 0) {
-    throw new Error(`Dependencies could not be installed. Run bun install inside ${name} to retry.`);
-  }
-  console.log(`\nYour app is ready.\n\n  cd ${name}\n  bun run dev\n`);
-  return dir;
-}
-
-if (import.meta.main) {
-  const args = process.argv.slice(2);
-  if (args.length === 1 && ["--help", "-h"].includes(args[0])) {
-    console.log("Usage: bun create disposabl-app@latest <appname>");
-  } else if (args.length !== 1 || args[0].startsWith("-")) {
-    console.error("Usage: bun create disposabl-app@latest <appname>");
-    process.exitCode = 1;
-  } else {
-    try {
-      await createApp(args[0]);
-    } catch (error) {
-      console.error(`Could not create app: ${error.message}`);
-      process.exitCode = 1;
-    }
-  }
-}