create-ropo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roberto Rodriguez Carbonell
+
+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/README.md

@@ -0,0 +1,45 @@
+# create-ropo
+
+Scaffold a new project from the [`stack-base`](https://github.com/RobertoRodriguezCarbonell/stack-base)
+boilerplate — Next.js 16 + Auth.js + Drizzle/Neon + Resend + (optional) R2.
+
+## Usage
+
+```bash
+pnpm create ropo my-app
+# or: npm create ropo@latest my-app
+# or: bun create ropo my-app
+```
+
+Then follow the prompts. It will:
+
+1. Clone the `stack-base` template (fresh git history).
+2. Rename the brand to your project name.
+3. Optionally `git init` + install dependencies.
+
+Finally:
+
+```bash
+cd my-app
+cp .env.example .env.local   # fill in your credentials
+pnpm db:migrate
+pnpm dev
+```
+
+## Notes
+
+- **Private template:** the default template repo is private, so cloning uses
+  your own git credentials (SSH or an https credential helper). Override the
+  source with the `ROPO_TEMPLATE` env var, e.g.:
+  ```bash
+  ROPO_TEMPLATE=git@github.com:RobertoRodriguezCarbonell/stack-base.git pnpm create ropo my-app
+  ```
+- **Zero dependencies:** the CLI uses only Node.js built-ins (`node >= 20`).
+- v1 scaffolds the `base` archetype only. Future archetypes (saas, landing,
+  internal-tool) will be added to the prompt as they exist.
+
+## Local development
+
+```bash
+node index.js ../tmp-test-app   # run the CLI without publishing
+```

package/index.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process"
+import {
+  existsSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs"
+import { basename, join, resolve } from "node:path"
+import { stdin as input, stdout as output } from "node:process"
+import { createInterface } from "node:readline/promises"
+
+/**
+ * create-ropo — scaffolds a new project from the stack-base boilerplate.
+ *
+ * Usage:
+ *   pnpm create ropo my-app            (interactive)
+ *   pnpm create ropo my-app -y         (accept defaults: install + git)
+ *   pnpm create ropo my-app --no-install --no-git
+ *
+ * v1 (base only): clone the template, strip its git history, rename the brand
+ * to your project name, optionally init git + install dependencies.
+ *
+ * The template defaults to the private stack-base repo, so cloning uses your
+ * own git credentials. Override the source with the ROPO_TEMPLATE env var.
+ */
+const TEMPLATE_REPO =
+  process.env.ROPO_TEMPLATE ??
+  "https://github.com/RobertoRodriguezCarbonell/stack-base.git"
+
+const BRAND = "stack-base"
+
+const c = {
+  dim: (s) => `\x1b[2m${s}\x1b[22m`,
+  bold: (s) => `\x1b[1m${s}\x1b[22m`,
+  green: (s) => `\x1b[32m${s}\x1b[39m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[39m`,
+  red: (s) => `\x1b[31m${s}\x1b[39m`,
+}
+
+function die(msg) {
+  console.error("\n" + c.red("✗ " + msg) + "\n")
+  process.exit(1)
+}
+
+function run(cmd, args, opts = {}) {
+  const r = spawnSync(cmd, args, { stdio: "inherit", ...opts })
+  if (r.error || r.status !== 0) {
+    die(`\`${cmd} ${args.join(" ")}\` failed.`)
+  }
+}
+
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent ?? ""
+  if (ua.startsWith("pnpm")) return "pnpm"
+  if (ua.startsWith("yarn")) return "yarn"
+  if (ua.startsWith("bun")) return "bun"
+  return "npm"
+}
+
+function slugify(name) {
+  return (
+    name
+      .trim()
+      .toLowerCase()
+      .replace(/[^a-z0-9-~]+/g, "-")
+      .replace(/^-+|-+$/g, "") || "my-app"
+  )
+}
+
+const SKIP_DIRS = new Set([".git", "node_modules", ".next", "drizzle", ".vercel"])
+const SKIP_FILES = new Set([
+  "pnpm-lock.yaml",
+  "package-lock.json",
+  "yarn.lock",
+  "bun.lockb",
+])
+const TEXT_EXT =
+  /\.(ts|tsx|js|jsx|mjs|cjs|mts|json|md|mdx|css|html|txt|yaml|yml)$/i
+
+/** Replace every occurrence of `from` with `to` in text files under `dir`. */
+function replaceInTree(dir, from, to) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (!SKIP_DIRS.has(entry.name)) {
+        replaceInTree(join(dir, entry.name), from, to)
+      }
+    } else if (
+      entry.isFile() &&
+      !SKIP_FILES.has(entry.name) &&
+      TEXT_EXT.test(entry.name)
+    ) {
+      const file = join(dir, entry.name)
+      const content = readFileSync(file, "utf8")
+      if (content.includes(from)) {
+        writeFileSync(file, content.split(from).join(to))
+      }
+    }
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2)
+  const positionals = args.filter((a) => !a.startsWith("-"))
+  const has = (...names) => names.some((n) => args.includes(n))
+
+  const yes = has("-y", "--yes")
+  const interactive = Boolean(input.isTTY) && !yes
+
+  console.log(
+    "\n" + c.bold(c.cyan("create-ropo")) + c.dim("  scaffold from stack-base\n")
+  )
+
+  const rl = interactive ? createInterface({ input, output }) : null
+  const ask = async (question, def) => {
+    if (!rl) return def
+    const a = (
+      await rl.question(`${question}${def ? c.dim(` (${def})`) : ""}: `)
+    ).trim()
+    return a || def || ""
+  }
+  const askYesNo = async (question, def) => {
+    const a = await ask(`${question} ${def ? "[Y/n]" : "[y/N]"}`, "")
+    if (!a) return def
+    return a.toLowerCase().startsWith("y")
+  }
+
+  // Target directory: positional arg, else prompt, else default.
+  const target = positionals[0] || (await ask("Project directory", "my-app"))
+  const dir = resolve(process.cwd(), target)
+  const name = slugify(basename(dir))
+
+  if (existsSync(dir) && readdirSync(dir).length > 0) {
+    rl?.close()
+    die(`Directory "${target}" already exists and is not empty.`)
+  }
+
+  // Install / git: flags win, otherwise prompt (or default when non-interactive).
+  const doInstall = has("--no-install")
+    ? false
+    : has("--install") || yes
+      ? true
+      : await askYesNo("Install dependencies now?", true)
+  const doGit = has("--no-git")
+    ? false
+    : has("--git") || yes
+      ? true
+      : await askYesNo("Initialize a git repository?", true)
+  rl?.close()
+
+  const pm = detectPackageManager()
+
+  console.log(c.dim(`\n→ Cloning template into ${target}/ …`))
+  run("git", ["clone", "--depth", "1", TEMPLATE_REPO, dir])
+  rmSync(join(dir, ".git"), { recursive: true, force: true })
+
+  console.log(c.dim(`→ Renaming "${BRAND}" → "${name}" …`))
+  replaceInTree(dir, BRAND, name)
+
+  if (doGit) {
+    console.log(c.dim("→ Initializing git …"))
+    run("git", ["init", "-q"], { cwd: dir })
+    run("git", ["add", "-A"], { cwd: dir })
+    run("git", ["commit", "-q", "-m", "chore: initialize from stack-base"], {
+      cwd: dir,
+    })
+  }
+
+  if (doInstall) {
+    console.log(c.dim(`→ Installing dependencies with ${pm} …\n`))
+    run(pm, ["install"], { cwd: dir })
+  }
+
+  const runCmd = pm === "npm" ? "npm run" : pm
+  console.log("\n" + c.green("✓ Done!") + " Next steps:\n")
+  console.log("  " + c.cyan(`cd ${target}`))
+  if (!doInstall) console.log("  " + c.cyan(`${pm} install`))
+  console.log(
+    "  " +
+      c.cyan("cp .env.example .env.local") +
+      c.dim("   # fill in your credentials")
+  )
+  console.log("  " + c.cyan(`${runCmd} db:migrate`))
+  console.log("  " + c.cyan(`${runCmd} dev`) + "\n")
+  console.log(
+    c.dim("  See README.md for the full setup (Neon, GitHub OAuth, Resend…).\n")
+  )
+}
+
+main().catch((error) => die(error?.message ?? String(error)))

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-ropo",
+  "version": "0.1.0",
+  "description": "Scaffold a new project from the stack-base boilerplate (Next.js 16 + Auth.js + Drizzle/Neon + Resend).",
+  "type": "module",
+  "bin": {
+    "create-ropo": "index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "create",
+    "scaffold",
+    "boilerplate",
+    "starter",
+    "nextjs",
+    "next.js",
+    "authjs",
+    "drizzle",
+    "stack-base"
+  ],
+  "author": "Roberto Rodriguez Carbonell",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RobertoRodriguezCarbonell/create-ropo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RobertoRodriguezCarbonell/create-ropo/issues"
+  },
+  "homepage": "https://github.com/RobertoRodriguezCarbonell/create-ropo#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}