create-disposabl-app 0.0.4 → 0.1.1

package/dist/index.js

@@ -1,127 +1,512 @@
 #!/usr/bin/env node
 
-// cli/index.ts
+// index.ts
 import { spawn, spawnSync } from "node:child_process";
+import { existsSync as existsSync2 } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command, CommanderError } from "commander";
+import * as p2 from "@clack/prompts";
+// package.json
+var version = "0.1.1";
+
+// options.ts
+var platforms = [
+  { id: "web", label: "Web", group: "Required", status: "required" },
+  { id: "android", label: "Android", group: "Mobile", status: "available" },
+  { id: "ios", label: "iOS", group: "Mobile", status: "available" },
+  { id: "windows", label: "Windows", group: "Desktop", status: "available" },
+  { id: "linux", label: "Linux", group: "Desktop", status: "available" },
+  { id: "macos", label: "macOS", group: "Desktop", status: "available" },
+  {
+    id: "mcp",
+    label: "MCP",
+    group: "MCP & plugins",
+    status: "available",
+    description: "Tools for AI assistants"
+  },
+  {
+    id: "openai-plugin",
+    label: "OpenAI Plugin",
+    description: "Tools and skills for OpenAI",
+    group: "MCP & plugins",
+    status: "available"
+  },
+  {
+    id: "claude-code-plugin",
+    label: "Claude Code Plugin",
+    description: "Tools and skills for Claude Code",
+    group: "MCP & plugins",
+    status: "available"
+  },
+  { id: "api", label: "API", group: "Coming soon", status: "disabled" },
+  { id: "cli", label: "CLI", group: "Coming soon", status: "disabled" },
+  {
+    id: "python-sdk",
+    label: "Python SDK",
+    group: "Coming soon",
+    status: "disabled"
+  },
+  {
+    id: "typescript-sdk",
+    label: "TypeScript SDK",
+    group: "Coming soon",
+    status: "disabled"
+  }
+];
+var platformDependencies = {
+  "openai-plugin": ["mcp"],
+  "claude-code-plugin": ["mcp"]
+};
+var features = [
+  { id: "docs", label: "Docs", hint: "apps/docs" },
+  { id: "blog", label: "Blog", hint: "apps/blog" },
+  { id: "changelog", label: "Changelog", hint: "apps/changelog" },
+  {
+    id: "authentication",
+    label: "Authentication",
+    hint: "Always included"
+  }
+];
+var requiredFeatures = ["authentication"];
+var parseList = (input) => input.split(",").map((value) => value.trim());
+function selectPlatforms(input = "web") {
+  const requested = parseList(input);
+  for (const id of requested) {
+    const option = platforms.find((platform) => platform.id === id);
+    if (!option)
+      throw new Error("Unknown platform " + JSON.stringify(id) + ". Use --list-options to see valid IDs.");
+    if (option.status === "disabled")
+      throw new Error(option.label + " is not available yet and cannot be selected.");
+  }
+  for (const [plugin, dependencies] of Object.entries(platformDependencies)) {
+    if (requested.includes(plugin))
+      requested.push(...dependencies);
+  }
+  return platforms.filter((option) => option.id === "web" || requested.includes(option.id)).map((option) => option.id);
+}
+function selectFeatures(input = "none") {
+  const requested = input === "none" ? [] : parseList(input);
+  for (const id of requested) {
+    if (!features.some((feature) => feature.id === id)) {
+      throw new Error("Unknown feature " + JSON.stringify(id) + ". Use --features none or --list-options to see valid IDs.");
+    }
+  }
+  return features.filter((option) => requiredFeatures.includes(option.id) || requested.includes(option.id)).map((option) => option.id);
+}
+function selectedFolders(config) {
+  const result = ["apps/web"];
+  if (config.platforms.some((platform) => platform === "android" || platform === "ios"))
+    result.push("apps/mobile");
+  if (config.platforms.some((platform) => ["windows", "linux", "macos"].includes(platform)))
+    result.push("apps/desktop");
+  for (const feature of config.features) {
+    if (feature !== "authentication")
+      result.push("apps/" + feature);
+  }
+  return result;
+}
+function validateName(name) {
+  if (!/^[a-z0-9][a-z0-9._-]*$/.test(name) || name.length > 214 || ["node_modules", "favicon.ico"].includes(name)) {
+    return "Use a lowercase project name with letters, numbers, dots, hyphens, or underscores.";
+  }
+}
+
+// platform-prompt.ts
+import { MultiSelectPrompt } from "@clack/core";
+import * as p from "@clack/prompts";
+import color from "picocolors";
+function createPlatformPrompt(streams = {}) {
+  return new MultiSelectPrompt({
+    ...streams,
+    options: platforms.map((option) => ({
+      value: option.id,
+      label: option.label,
+      disabled: option.status !== "available",
+      description: "description" in option ? option.description : ""
+    })),
+    required: false,
+    render() {
+      const explicit = this.value ?? [];
+      const selected = selectPlatforms(explicit.length ? explicit.join(",") : "web");
+      const title = `${p.symbol(this.state)}  Choose platforms`;
+      const bar = color.dim(p.S_BAR);
+      if (this.state === "submit") {
+        const labels = this.options.filter((option) => selected.includes(option.value)).map((option) => option.label.trim());
+        return `${title}
+${bar}  ${color.dim(labels.join(", ") || "Web only")}`;
+      }
+      if (this.state === "cancel")
+        return `${title}
+${bar}  ${color.dim("Cancelled")}`;
+      const style = (option, active) => {
+        const checked = selected.includes(option.value);
+        const hint = option.value === "web" ? "Required" : option.disabled ? "Unavailable" : option.description + (option.value.endsWith("-plugin") ? " · Requires MCP" : "");
+        const checkbox = checked ? p.S_CHECKBOX_SELECTED : active ? p.S_CHECKBOX_ACTIVE : p.S_CHECKBOX_INACTIVE;
+        const label = `${checkbox} ${option.label}`;
+        return (option.value === "web" ? color.green(label) : option.disabled ? color.dim(label) : active ? color.cyan(label) : label) + (hint ? color.dim(` (${hint})`) : "");
+      };
+      const unavailable = this.options.filter((option) => option.disabled && option.value !== "web");
+      const rows = p.limitOptions({
+        options: this.options.filter((option) => !unavailable.includes(option)),
+        cursor: this.cursor,
+        output: streams.output,
+        columnPadding: 3,
+        rowPadding: 6 + unavailable.length,
+        style
+      });
+      return [
+        title,
+        ...rows.map((row) => `${bar}  ${row}`),
+        ...unavailable.map((option) => `${bar}  ${style(option, false)}`),
+        `${bar}  ${color.dim("↑/↓ move · Space select · Enter confirm")}`,
+        color.dim(p.S_BAR_END)
+      ].join(`
+`);
+    }
+  });
+}
+
+// project-setup.ts
+import { clearScreenDown, cursorTo, moveCursor } from "node:readline";
+import color2 from "picocolors";
+import { performance } from "node:perf_hooks";
+function setupTable(name, config, status, columns = 80) {
+  const installation = status.installation + (status.elapsedSeconds === undefined ? "" : ` (${status.elapsedSeconds.toFixed(2)}s)`);
+  const rows = [
+    ["App", name],
+    ["Disposabl Version", config.version],
+    [
+      "Platforms",
+      config.platforms.map((id) => platforms.find((p) => p.id === id).label).join(", ")
+    ],
+    [
+      "Features",
+      config.features.map((id) => features.find((f) => f.id === id).label).join(", ") || "None"
+    ],
+    ["Installation", installation]
+  ];
+  const labelWidth = Math.max(...rows.map(([label]) => label.length));
+  const padding = labelWidth + 7;
+  const contentWidth = Math.max(46, ...rows.map(([, value]) => value.length + padding));
+  const width = Math.max(24, Math.min(columns - 1, 80, contentWidth));
+  const valueWidth = width - padding;
+  const border = color2.dim("─".repeat(width - 2));
+  const result = [color2.bold("App Setup"), `┌${border}┐`];
+  for (const [label, value] of rows) {
+    let remaining = value;
+    let first = true;
+    do {
+      let end = valueWidth;
+      if (remaining.length > end) {
+        const space = remaining.lastIndexOf(" ", end);
+        if (space > 0)
+          end = space;
+      }
+      const part = remaining.slice(0, end);
+      remaining = remaining.slice(end).trimStart();
+      const cell = part.padEnd(valueWidth);
+      const isStatus = label === "Installation";
+      const styled = isStatus && status.installation === "Complete" ? color2.green(cell) : isStatus && status.installation === "Failed" ? color2.red(cell) : label === "App" ? color2.bold(cell) : cell;
+      result.push(`│ ${(first ? label : "").padEnd(labelWidth)} │ ${styled} │`);
+      first = false;
+    } while (remaining);
+  }
+  result.push(`└${border}┘`);
+  return result.join(`
+`);
+}
+function projectSetup(name, config) {
+  const live = Boolean(process.stdout.isTTY);
+  const status = { installation: "Pending" };
+  let lines = 0;
+  let started;
+  let timer;
+  function render() {
+    if (live && lines) {
+      moveCursor(process.stdout, 0, -lines);
+      cursorTo(process.stdout, 0);
+      clearScreenDown(process.stdout);
+    }
+    const frame = setupTable(name, config, status, process.stdout.columns);
+    process.stdout.write(frame + `
+`);
+    lines = frame.split(`
+`).length;
+  }
+  if (live)
+    render();
+  return {
+    live,
+    installing() {
+      started = performance.now();
+      status.installation = "Installing";
+      const tick = () => {
+        status.elapsedSeconds = (performance.now() - started) / 1000;
+        if (live)
+          render();
+      };
+      tick();
+      if (live)
+        timer = setInterval(tick, 100);
+    },
+    finish(next) {
+      clearInterval(timer);
+      Object.assign(status, next);
+      if (started !== undefined)
+        status.elapsedSeconds = (performance.now() - started) / 1000;
+      render();
+    }
+  };
+}
+
+// scaffold.ts
 import {
   cp,
   mkdir,
-  readdir,
   readFile,
+  readdir,
   rename,
+  rm,
   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";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+async function createProject(template, destination, name, config) {
+  config = {
+    ...config,
+    features: selectFeatures(config.features.join(",") || "none")
+  };
+  const folders = selectedFolders(config);
+  for (const folder of folders) {
+    if (!existsSync(join(template, folder, "package.json"))) {
+      throw new Error("The bundled starter is missing " + folder + "/package.json. Rebuild the CLI.");
+    }
+  }
+  await mkdir(destination);
+  try {
+    for (const entry of await readdir(template)) {
+      await cp(join(template, entry), join(destination, entry), {
+        recursive: true,
+        force: false,
+        errorOnExist: true
+      });
+    }
+    for (const entry of await readdir(join(destination, "apps"))) {
+      if (!folders.includes("apps/" + entry))
+        await rm(join(destination, "apps", entry), {
+          recursive: true,
+          force: true
+        });
+    }
+    if (existsSync(join(destination, "gitignore"))) {
+      await rename(join(destination, "gitignore"), join(destination, ".gitignore"));
+    }
+    const manifestPath = join(destination, "package.json");
+    const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+    manifest.name = name;
+    await writeFile(manifestPath, JSON.stringify(manifest, null, 2) + `
+`);
+    await writeFile(join(destination, "disposabl.json"), JSON.stringify(config, null, 2) + `
+`);
+  } catch (error) {
+    await rm(destination, { recursive: true, force: true });
+    throw error;
+  }
+  return folders;
+}
 
-// 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}.
+// index.ts
+var jsonOutput = process.argv.slice(2).includes("--json");
+var program = new Command("create-disposabl-app").description("Create a Disposabl starter. Web and authentication are always included.").version(version, "-v, --version").argument("[appname]", "App name and new directory").option("--platforms <ids>", "Comma-separated platform IDs; Web is always included").option("--features <ids>", "Comma-separated optional feature IDs, or none; authentication is always included").option("-y, --yes", "Skip prompts; include Web and authentication, with no optional features").option("--skip-install", "Create files without running bun install").option("--list-options", "List every platform and feature, including disabled choices").option("--json", "Skip prompts and emit a JSON result or error; install logs go to stderr").helpOption("-h, --help").addHelpText("after", `
+Platforms:
+  web (required), android, ios, windows, linux, macos, mcp,
+  openai-plugin, claude-code-plugin
+  Either plugin automatically includes MCP.
+  Disabled: api, cli, python-sdk, typescript-sdk
+
+Optional features:
+  docs, blog, changelog
+  Authentication is always included, including with --features none.
 
-Using bun.
+Examples:
+  bun create disposabl-app@latest
+  bun create disposabl-app@latest my-app --yes
+  bun create disposabl-app@latest my-app --platforms web,android,ios,mcp --features docs --yes
+  bun create disposabl-app@latest my-app --platforms web --features none --skip-install --json
+  bun create disposabl-app@latest --list-options --json
 
-Platform: Web
-Features: ${docs ? "Docs" : "None"}
+Without a TTY, the CLI never prompts. Supply an app name.
+Platform and feature choices are saved in disposabl.json.
+The starter includes web and backend authentication code. No appId or Convex deployment is created.
+`).configureOutput({ writeErr: () => {} }).exitOverride();
+
+class Cancelled extends Error {
+}
+function answer(value) {
+  if (p2.isCancel(value))
+    throw new Cancelled("Cancelled. No files were created.");
+  return value;
+}
+function showOptions(json) {
+  if (json) {
+    console.log(JSON.stringify({
+      platforms,
+      platformDependencies,
+      features,
+      requiredFeatures,
+      defaults: { platforms: ["web"], features: selectFeatures() },
+      folders: {
+        web: "apps/web",
+        android: "apps/mobile",
+        ios: "apps/mobile",
+        windows: "apps/desktop",
+        linux: "apps/desktop",
+        macos: "apps/desktop",
+        docs: "apps/docs",
+        blog: "apps/blog",
+        changelog: "apps/changelog"
+      },
+      configOnly: ["mcp", "openai-plugin", "claude-code-plugin"]
+    }, null, 2));
+    return;
+  }
+  console.log(`Platforms
+`);
+  for (const option of platforms)
+    console.log("  " + option.id.padEnd(21) + option.label.padEnd(20) + option.status);
+  console.log(`
+OpenAI Plugin and Claude Code Plugin automatically include MCP.`);
+  console.log(`
+Features
 `);
-  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
+  for (const option of features)
+    console.log("  " + option.id.padEnd(21) + option.hint);
+  console.log(`
+Web and authentication are always included. No optional features are selected by default. Use --platforms and --features with the IDs above.`);
+}
+async function install(directory, interactive) {
+  await new Promise((done, reject) => {
+    const child = spawn("bun", ["install"], {
+      cwd: directory,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, NODE_ENV: "development" }
     });
+    let detail = "";
+    const onData = (chunk) => {
+      detail = (detail + chunk.toString()).slice(-4000);
+      if (!interactive)
+        process.stderr.write(chunk);
+    };
+    child.stdout.on("data", onData);
+    child.stderr.on("data", onData);
+    child.once("error", reject);
+    child.once("close", (code) => code === 0 ? done() : reject(new Error("bun install failed. The project was created at " + directory + `. Run bun install there to retry.
+` + detail.trim())));
+  });
+}
+async function main() {
+  program.parse();
+  const options = program.opts();
+  if (options.listOptions)
+    return showOptions(Boolean(options.json));
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY && !p2.isCI() && !options.yes && !options.json);
+  let chosenPlatforms = selectPlatforms(options.platforms);
+  let chosenFeatures = selectFeatures(options.features);
+  let name = program.args[0];
+  if (interactive) {
+    if (!name)
+      name = answer(await p2.text({
+        message: "App name",
+        placeholder: "my-app",
+        defaultValue: "my-app",
+        validate: (value) => validateName(value ?? "") || (existsSync2(resolve(value ?? "")) ? "That directory already exists. Choose a new name." : undefined)
+      }));
   }
-  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.`)));
+  if (!name)
+    throw new Error("Provide an app name in non-interactive mode. Example: bun create disposabl-app@latest my-app --platforms web --features none --yes");
+  const invalidName = validateName(name);
+  if (invalidName)
+    throw new Error(invalidName);
+  const directory = resolve(name);
+  if (existsSync2(directory))
+    throw new Error("Directory already exists: " + directory + ". Choose a new name; existing files are never overwritten.");
+  if (interactive && options.platforms === undefined) {
+    const selected = answer(await createPlatformPrompt().prompt() ?? []);
+    chosenPlatforms = selectPlatforms(selected.length ? selected.join(",") : "web");
+  }
+  if (interactive && options.features === undefined) {
+    const selected = answer(await p2.multiselect({
+      message: "Choose optional features (authentication is always included)",
+      options: features.filter((feature) => !requiredFeatures.includes(feature.id)).map((feature) => ({
+        value: feature.id,
+        label: feature.label,
+        hint: feature.hint
+      })),
+      required: false
+    }));
+    chosenFeatures = selectFeatures(selected.length ? selected.join(",") : "none");
+  }
+  const config = {
+    version,
+    platforms: chosenPlatforms,
+    features: chosenFeatures
+  };
+  const setup = options.json ? undefined : projectSetup(name, config);
+  let installationStarted = false;
+  try {
+    if (!options.skipInstall && spawnSync("bun", ["--version"], { stdio: "ignore" }).status !== 0)
+      throw new Error("Install Bun first, or pass --skip-install to create the files only.");
+    const template = fileURLToPath(new URL("./templates/default", import.meta.url));
+    await createProject(template, directory, name, config);
+    if (!options.skipInstall) {
+      installationStarted = true;
+      setup?.installing();
+      await install(directory, Boolean(setup?.live));
+    }
+    setup?.finish({
+      installation: options.skipInstall ? "Skipped" : "Complete"
+    });
+  } catch (error) {
+    setup?.finish({
+      installation: installationStarted ? "Failed" : "Not started"
     });
+    throw error;
   }
-  console.log(`
-Success! Created ${name} at ${dir}
-
-Get started:
+  const folders = selectedFolders(config);
+  if (options.json) {
+    console.log(JSON.stringify({
+      status: "created",
+      name,
+      directory,
+      configFile: "disposabl.json",
+      ...config,
+      folders,
+      installed: !options.skipInstall
+    }, null, 2));
+  } else {
+    console.log(`
+Next steps
 
-  cd ${name}
-${options.skipInstall ? `  bun install
-` : ""}  bun run dev
+  cd ` + name + `
+  bun run dev
 `);
+  }
+}
+try {
+  await main();
 } catch (error) {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exitCode = 1;
+  if (error instanceof CommanderError && error.exitCode === 0) {
+    process.exitCode = 0;
+  } else if (error instanceof Cancelled) {
+    p2.cancel(error.message);
+    process.exitCode = 130;
+  } else {
+    const message = error instanceof Error ? error.message : String(error);
+    if (jsonOutput)
+      console.log(JSON.stringify({ status: "error", message }));
+    else
+      console.error("Error: " + message);
+    process.exitCode = 1;
+  }
 }

package/dist/templates/default/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Disposabl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/templates/default/apps/blog/package.json

@@ -0,0 +1 @@
+{}

package/dist/templates/default/apps/changelog/package.json

@@ -0,0 +1 @@
+{}

package/dist/templates/default/apps/desktop/.oxfmtrc.json

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "printWidth": 80,
+  "sortPackageJson": false
+}

package/dist/templates/default/apps/desktop/.oxlintrc.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "categories": {
+    "correctness": "warn"
+  }
+}