@jlmx/starter 1.1.3 → 1.2.0

package/README.md

@@ -4,16 +4,44 @@ CLI to scaffold new projects with my preferred stack, optimized for Cloudflare d
 
 ## Usage
 
+Interactive mode — prompts for all options:
+
+```bash
+bunx @jlmx/starter
+```
+
+Pass a project name to skip the name prompt:
+
 ```bash
 bunx @jlmx/starter my-app
 ```
 
-Or run interactively:
+One-liner with flags — fully non-interactive:
 
 ```bash
-bunx @jlmx/starter
+bunx @jlmx/starter my-app --template nextjs --features tailwind,fonts,cloudflare --bindings d1,r2 --ai claude
+```
+
+Accept all defaults with no prompts:
+
+```bash
+bunx @jlmx/starter my-app --yes
 ```
 
+## Options
+
+| Flag | Values | Description |
+|------|--------|-------------|
+| `--template` | `tanstack-start`, `nextjs` | Framework template |
+| `--features` | `tailwind,fonts,auth,cloudflare` | Comma-separated feature list |
+| `--bindings` | `d1,r2,kv,ai,queues` | Cloudflare bindings (requires `cloudflare` feature) |
+| `--ai` | `none`, `agents`, `claude`, `both` | AI coding assistant instructions |
+| `-y, --yes` | — | Accept all defaults, skip all prompts |
+| `-h, --help` | — | Show help |
+| `-v, --version` | — | Show version |
+
+Defaults (used with `--yes`): `tanstack-start`, features `tailwind,fonts,cloudflare`, no bindings, no AI instructions.
+
 ## Templates
 
 - **TanStack Start** - Full-stack React with TanStack Router
@@ -22,28 +50,28 @@ bunx @jlmx/starter
 ## Features
 
 All projects include:
-- **Tailwind CSS** - Custom design system with `tailwindcss-animate`
-- **Custom Fonts** - Inter + JetBrains Mono via Fontsource
 - **Biome** - Fast linting and formatting (replaces ESLint + Prettier)
 - **Logger** - Structured logging utility
 - **Result Type** - Explicit error handling (neverthrow pattern)
 
 Optional:
+- **Tailwind CSS** - Custom design system with `tailwindcss-animate`
+- **Custom Fonts** - Inter + JetBrains Mono via Fontsource
 - **Authentication** - Better Auth + Drizzle ORM
 - **Cloudflare Workers** - Edge deployment with D1, R2, KV, AI, Queues
 - **AI Instructions** - AGENTS.md and/or CLAUDE.md for coding assistants
 
 ## Cloudflare Bindings
 
-When Cloudflare is selected, you can enable:
+When `cloudflare` is selected, you can enable:
 
 | Binding | Description |
 |---------|-------------|
-| D1 | SQLite database at the edge |
-| R2 | S3-compatible object storage |
-| KV | Key-value storage |
-| AI | Workers AI models |
-| Queues | Message queues |
+| `d1` | SQLite database at the edge |
+| `r2` | S3-compatible object storage |
+| `kv` | Key-value storage |
+| `ai` | Workers AI models |
+| `queues` | Message queues |
 
 ## Development
 

package/dist/index.js

@@ -181,12 +181,18 @@ Usage:
   bunx @jlmx/starter [project-name] [options]
 
 Options:
-  -h, --help     Show this help message
-  -v, --version  Show version number
+  -h, --help                    Show this help message
+  -v, --version                 Show version number
+  -y, --yes                     Accept defaults (no prompts)
+  --template <name>             tanstack-start | nextjs
+  --features <list>             Comma-separated: tailwind,fonts,auth,cloudflare
+  --bindings <list>             Comma-separated: d1,r2,kv,ai,queues
+  --ai <value>                  none | agents | claude | both
 
 Examples:
   bunx @jlmx/starter my-app
-  bunx @jlmx/starter
+  bunx @jlmx/starter my-app --template nextjs --features tailwind,fonts,cloudflare --bindings d1,r2 --ai claude
+  bunx @jlmx/starter my-app --yes
 
 Templates:
   tanstack-start  Full-stack React with TanStack Router
@@ -215,10 +221,19 @@ async function main() {
     console.info(VERSION);
     process.exit(0);
   }
+  const useDefaults = args.includes("-y") || args.includes("--yes");
+  const DEFAULT_TEMPLATE = "tanstack-start";
+  const DEFAULT_FEATURES = ["tailwind", "fonts", "cloudflare"];
+  const DEFAULT_BINDINGS = [];
+  const DEFAULT_AI = "none";
   console.clear();
   p.intro("@jlmx/starter");
   let projectName = args.find((arg) => !arg.startsWith("-"));
   if (!projectName) {
+    if (useDefaults) {
+      p.log.error("--yes requires a project name as the first argument");
+      process.exit(1);
+    }
     const nameResult = await p.text({
       message: "Project name:",
       placeholder: "my-app",
@@ -235,40 +250,69 @@ async function main() {
     }
     projectName = nameResult;
   }
-  const template = await p.select({
-    message: "Select a template:",
-    options: [
-      {
-        value: "tanstack-start",
-        label: "TanStack Start",
-        hint: "Full-stack React with TanStack Router"
-      },
-      {
-        value: "nextjs",
-        label: "Next.js",
-        hint: "Full-stack React with App Router"
-      }
-    ]
-  });
-  if (p.isCancel(template)) {
-    p.cancel("Cancelled");
-    process.exit(0);
+  const templateFlag = getFlagValue(args, "--template");
+  const validTemplates = ["tanstack-start", "nextjs"];
+  let selectedTemplate;
+  if (templateFlag) {
+    if (!validTemplates.includes(templateFlag)) {
+      p.log.error(`Invalid template "${templateFlag}". Choose: ${validTemplates.join(", ")}`);
+      process.exit(1);
+    }
+    selectedTemplate = templateFlag;
+  } else if (useDefaults) {
+    selectedTemplate = DEFAULT_TEMPLATE;
+  } else {
+    const template = await p.select({
+      message: "Select a template:",
+      options: [
+        {
+          value: "tanstack-start",
+          label: "TanStack Start",
+          hint: "Full-stack React with TanStack Router"
+        },
+        {
+          value: "nextjs",
+          label: "Next.js",
+          hint: "Full-stack React with App Router"
+        }
+      ]
+    });
+    if (p.isCancel(template)) {
+      p.cancel("Cancelled");
+      process.exit(0);
+    }
+    selectedTemplate = template;
   }
-  const features = await p.multiselect({
-    message: "Select features:",
-    options: [
-      { value: "tailwind", label: "Tailwind CSS", hint: "design system + tailwindcss-animate" },
-      { value: "fonts", label: "Custom Fonts", hint: "Inter + JetBrains Mono" },
-      { value: "auth", label: "Authentication", hint: "Better Auth + D1" },
-      { value: "cloudflare", label: "Cloudflare Workers", hint: "deployment config" }
-    ],
-    initialValues: ["tailwind", "fonts", "cloudflare"]
-  });
-  if (p.isCancel(features)) {
-    p.cancel("Cancelled");
-    process.exit(0);
+  const featuresFlag = getFlagValue(args, "--features");
+  const validFeatures = ["tailwind", "fonts", "auth", "cloudflare"];
+  let selectedFeatures;
+  if (featuresFlag) {
+    const parsed = featuresFlag.split(",").map((f) => f.trim());
+    const invalid = parsed.filter((f) => !validFeatures.includes(f));
+    if (invalid.length > 0) {
+      p.log.error(`Invalid features: ${invalid.join(", ")}. Choose from: ${validFeatures.join(", ")}`);
+      process.exit(1);
+    }
+    selectedFeatures = parsed;
+  } else if (useDefaults) {
+    selectedFeatures = [...DEFAULT_FEATURES];
+  } else {
+    const features = await p.multiselect({
+      message: "Select features:",
+      options: [
+        { value: "tailwind", label: "Tailwind CSS", hint: "design system + tailwindcss-animate" },
+        { value: "fonts", label: "Custom Fonts", hint: "Inter + JetBrains Mono" },
+        { value: "auth", label: "Authentication", hint: "Better Auth + D1" },
+        { value: "cloudflare", label: "Cloudflare Workers", hint: "deployment config" }
+      ],
+      initialValues: ["tailwind", "fonts", "cloudflare"]
+    });
+    if (p.isCancel(features)) {
+      p.cancel("Cancelled");
+      process.exit(0);
+    }
+    selectedFeatures = features;
   }
-  const selectedFeatures = features;
   let cfBindings = [];
   if (selectedFeatures.includes("auth")) {
     if (!selectedFeatures.includes("cloudflare")) {
@@ -277,65 +321,91 @@ async function main() {
     }
   }
   if (selectedFeatures.includes("cloudflare")) {
+    const bindingsFlag = getFlagValue(args, "--bindings");
+    const validBindings = ["d1", "r2", "kv", "ai", "queues"];
     const needsD1 = selectedFeatures.includes("auth");
-    const bindings = await p.multiselect({
-      message: "Cloudflare platform features:",
+    if (bindingsFlag !== undefined) {
+      const parsed = bindingsFlag === "" ? [] : bindingsFlag.split(",").map((b) => b.trim());
+      const invalid = parsed.filter((b) => !validBindings.includes(b));
+      if (invalid.length > 0) {
+        p.log.error(`Invalid bindings: ${invalid.join(", ")}. Choose from: ${validBindings.join(", ")}`);
+        process.exit(1);
+      }
+      cfBindings = parsed;
+    } else if (useDefaults) {
+      cfBindings = [...DEFAULT_BINDINGS];
+    } else {
+      const bindings = await p.multiselect({
+        message: "Cloudflare platform features:",
+        options: [
+          {
+            value: "d1",
+            label: "D1 Database",
+            hint: needsD1 ? "required for auth" : "SQLite at the edge"
+          },
+          { value: "r2", label: "R2 Storage", hint: "S3-compatible object storage" },
+          { value: "kv", label: "KV Store", hint: "key-value storage" },
+          { value: "ai", label: "Workers AI", hint: "run AI models" },
+          { value: "queues", label: "Queues", hint: "message queues" }
+        ],
+        initialValues: needsD1 ? ["d1"] : [],
+        required: false
+      });
+      if (p.isCancel(bindings)) {
+        p.cancel("Cancelled");
+        process.exit(0);
+      }
+      cfBindings = bindings;
+    }
+    if (needsD1 && !cfBindings.includes("d1")) {
+      cfBindings.push("d1");
+      p.log.info("D1 Database enabled (required for auth)");
+    }
+  }
+  const aiFlag = getFlagValue(args, "--ai");
+  const validAi = ["none", "agents", "claude", "both"];
+  let selectedAiInstructions;
+  if (aiFlag) {
+    if (!validAi.includes(aiFlag)) {
+      p.log.error(`Invalid --ai value "${aiFlag}". Choose: ${validAi.join(", ")}`);
+      process.exit(1);
+    }
+    selectedAiInstructions = aiFlag;
+  } else if (useDefaults) {
+    selectedAiInstructions = DEFAULT_AI;
+  } else {
+    const aiInstructions = await p.select({
+      message: "AI coding assistant instructions:",
       options: [
         {
-          value: "d1",
-          label: "D1 Database",
-          hint: needsD1 ? "required for auth" : "SQLite at the edge"
+          value: "none",
+          label: "None",
+          hint: "skip AI instructions"
         },
-        { value: "r2", label: "R2 Storage", hint: "S3-compatible object storage" },
-        { value: "kv", label: "KV Store", hint: "key-value storage" },
-        { value: "ai", label: "Workers AI", hint: "run AI models" },
-        { value: "queues", label: "Queues", hint: "message queues" }
-      ],
-      initialValues: needsD1 ? ["d1"] : [],
-      required: false
+        {
+          value: "agents",
+          label: "AGENTS.md",
+          hint: "generic (Codex, Cursor, etc.)"
+        },
+        {
+          value: "claude",
+          label: "CLAUDE.md",
+          hint: "Claude Code specific"
+        },
+        {
+          value: "both",
+          label: "Both",
+          hint: "AGENTS.md + CLAUDE.md symlink"
+        }
+      ]
     });
-    if (p.isCancel(bindings)) {
+    if (p.isCancel(aiInstructions)) {
       p.cancel("Cancelled");
       process.exit(0);
     }
-    cfBindings = bindings;
-    if (needsD1 && !cfBindings.includes("d1")) {
-      cfBindings.push("d1");
-      p.log.info("D1 Database enabled (required for auth)");
-    }
+    selectedAiInstructions = aiInstructions;
   }
-  const aiInstructions = await p.select({
-    message: "AI coding assistant instructions:",
-    options: [
-      {
-        value: "none",
-        label: "None",
-        hint: "skip AI instructions"
-      },
-      {
-        value: "agents",
-        label: "AGENTS.md",
-        hint: "generic (Codex, Cursor, etc.)"
-      },
-      {
-        value: "claude",
-        label: "CLAUDE.md",
-        hint: "Claude Code specific"
-      },
-      {
-        value: "both",
-        label: "Both",
-        hint: "AGENTS.md + CLAUDE.md symlink"
-      }
-    ]
-  });
-  if (p.isCancel(aiInstructions)) {
-    p.cancel("Cancelled");
-    process.exit(0);
-  }
-  const selectedAiInstructions = aiInstructions;
   const projectPath = resolve(process.cwd(), projectName);
-  const selectedTemplate = template;
   const s = p.spinner();
   if (selectedTemplate === "tanstack-start") {
     s.start("Creating TanStack Start project...");
@@ -617,4 +687,11 @@ ${envVarPrefix}BETTER_AUTH_URL=http://localhost:3000
 
   ${nextSteps}`);
 }
-main().catch(console.error);
+main().catch((err) => {
+  if (err instanceof Error) {
+    console.error(`Error: ${err.message}`);
+  } else {
+    console.error(err);
+  }
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jlmx/starter",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Scaffold new projects with jlmx's preferred stack",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
   "scripts": {
     "build": "bun build ./src/index.ts --outdir ./dist --target bun --packages external",
     "dev": "bun run ./src/index.ts",
+    "test": "bun test",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",