create-disposabl-app 0.0.3 → 0.0.4

package/README.md

@@ -1,23 +1,34 @@
 # Create Disposabl app
 
-Create an app with [Bun](https://bun.com):
-
 ```sh
-bun create disposabl-app@latest my-app
-cd my-app
-bun run dev
+bun create disposabl-app@latest
+# or
+npx create-disposabl-app@latest my-app
 ```
 
-Or use Node.js 22 or later:
+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
-npx create-disposabl-app@latest my-app
-npx create-disposabl-app@latest -h
-npx create-disposabl-app@latest -v
+bun install
+bun fmt
+bun run lint
+bun run typecheck
+bun run build
+bun run dev
 ```
 
-Options: `-h` / `--help`, `-v` / `--version`, and `--skip-install`.
+## 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 starter is bundled in the package. The CLI copies only its files, installs dependencies with Bun, and prints the next commands. Existing folders are never overwritten. Installing dependencies and running the app require Bun; help, version, and `--skip-install` work without it. The starter is an `index.ts` using `Bun.serve`.
+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.
 
-The standard CLI uses Node.js 22 or later. In a Bun-only environment, run `bunx --bun create-disposabl-app@latest my-app`.
+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

@@ -1,9 +1,6 @@
 #!/usr/bin/env node
 
 // cli/index.ts
-import { parseArgs } from "node:util";
-
-// cli/create-app.ts
 import { spawn, spawnSync } from "node:child_process";
 import {
   cp,
@@ -15,93 +12,115 @@ import {
 } from "node:fs/promises";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-async function createApp(name, { cwd = process.cwd(), skipInstall = false } = {}) {
-  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.");
-  }
-  if (!skipInstall && spawnSync("bun", ["--version"]).status !== 0) {
-    throw new Error("Install Bun from https://bun.com before creating an app.");
+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;
   }
-  const dir = resolve(cwd, name);
+  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 ${name}...`);
+  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));
-  await Promise.all((await readdir(template)).map((file) => cp(resolve(template, file), resolve(dir, file), {
-    recursive: true,
-    force: false,
-    errorOnExist: true
-  })));
+  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 (!skipInstall) {
-    await new Promise((resolveInstall, reject) => {
-      const install = spawn("bun", ["install"], {
+  if (!options.skipInstall) {
+    await new Promise((done, reject) => {
+      const child = spawn("bun", ["install"], {
         cwd: dir,
         stdio: "inherit",
         env: { ...process.env, NODE_ENV: "development" }
       });
-      install.once("error", reject);
-      install.once("close", (code) => {
-        if (code === 0)
-          resolveInstall();
-        else {
-          reject(new Error(`Dependencies could not be installed. Run bun install inside ${name} to retry.`));
-        }
-      });
+      child.once("error", reject);
+      child.once("close", (code) => code === 0 ? done() : reject(new Error(`Run bun install inside ${name} to retry.`)));
     });
   }
   console.log(`
-Your app is ready.
+Success! Created ${name} at ${dir}
+
+Get started:
 
   cd ${name}
-${skipInstall ? `  bun install
+${options.skipInstall ? `  bun install
 ` : ""}  bun run dev
 `);
-  return dir;
-}
-// cli/package.json
-var version = "0.0.3";
-
-// cli/index.ts
-var help = `Usage: create-disposabl-app <appname> [options]
-
-Create a Disposabl app from the bundled starter template.
-
-Options:
-  -h, --help       Show this help message
-  -v, --version    Show the CLI version
-  --skip-install   Copy the starter without running bun install
-
-Examples:
-  bun create disposabl-app@latest my-app
-  npx create-disposabl-app@latest my-app
-  npx create-disposabl-app@latest --help
-
-The generated app uses Bun. Install it from https://bun.com.
-`;
-try {
-  const { values, positionals } = parseArgs({
-    allowPositionals: true,
-    options: {
-      help: { type: "boolean", short: "h" },
-      version: { type: "boolean", short: "v" },
-      "skip-install": { type: "boolean" }
-    }
-  });
-  if (values.help)
-    console.log(help);
-  else if (values.version)
-    console.log(version);
-  else if (positionals.length !== 1) {
-    console.error(help);
-    process.exitCode = 1;
-  } else {
-    await createApp(positionals[0], { skipInstall: values["skip-install"] });
-  }
 } catch (error) {
   console.error(error instanceof Error ? error.message : String(error));
   process.exitCode = 1;

package/dist/templates/default/README.md

@@ -7,3 +7,6 @@ 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/index.ts

@@ -1,6 +1,12 @@
 const server = Bun.serve({
   port: process.env.PORT ?? 3000,
-  fetch() {
+  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");
   },
 });

package/dist/templates/default/package.json

@@ -4,6 +4,14 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "bun --hot index.ts"
+    "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.3",
+  "version": "0.0.4",
   "description": "Create a Disposabl app with Bun",
   "type": "module",
   "license": "MIT",
@@ -17,12 +17,16 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=22.12.0"
   },
   "scripts": {
     "build": "bun build.ts"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "commander": "15.0.0",
+    "prompts": "2.4.2"
   }
 }