@sb-codex/create-sb-app 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Slim Bouchoucha
+
+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,48 @@
+# @sb-codex/create-sb-app
+
+Scaffold a new multi-tenant SaaS project from the [sb-codex starter](https://github.com/SB-SLIM/react-app-starter). Downloads the full monorepo (apps + packages in `workspace:^`, self-contained) and replaces project-specific values for you.
+
+## Usage
+
+```bash
+pnpm create @sb-codex/sb-app my-saas
+# or: npm create @sb-codex/sb-app my-saas
+```
+
+Prompts:
+
+- **Project directory** — where to create the project
+- **Project name** — root `package.json` name
+- **Production domain** — replaces the reference domain across docs, compose and Traefik config
+- **git init** — start with fresh git history
+
+Then:
+
+```bash
+cd my-saas
+pnpm install
+pnpm dev
+```
+
+## What it replaces
+
+| Token                               | Replaced with                |
+| ----------------------------------- | ---------------------------- |
+| `slimbouchoucha.tn`                 | your domain                  |
+| `ghcr.io/sb-slim/react-app-starter` | `ghcr.io/your-gh-org/<name>` |
+| `SB-SLIM/react-app-starter`         | `your-gh-org/<name>`         |
+| `152.53.187.54`                     | `YOUR_VPS_IP`                |
+| Notion page id                      | `YOUR_NOTION_PAGE_ID`        |
+
+It also drops its own `packages/create-sb-app` from the generated project and copies `.env.example` → `.env`.
+
+## Local usage (from the monorepo)
+
+```bash
+pnpm --filter @sb-codex/create-sb-app build
+node packages/create-sb-app/dist/index.js ../my-saas
+```
+
+---
+
+Part of the [sb-codex SaaS starter](https://github.com/SB-SLIM/react-app-starter). See [docs/plugins](../../docs/plugins/README.md).

package/dist/index.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import {
+  existsSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+  rmSync,
+  copyFileSync
+} from "fs";
+import { join, extname, basename } from "path";
+import { execSync } from "child_process";
+import {
+  intro,
+  outro,
+  text,
+  confirm,
+  spinner,
+  isCancel,
+  cancel,
+  note
+} from "@clack/prompts";
+import { downloadTemplate } from "giget";
+import pc from "picocolors";
+
+// src/replacements.ts
+var NOTION_PAGE_ID_DASHED = /3741c921-e61d-815f-8b78-e896fe1b65f3/g;
+var NOTION_PAGE_ID_COMPACT = /3741c921e61d815f8b78e896fe1b65f3/g;
+function buildReplacements(answers) {
+  const { name, domain } = answers;
+  return [
+    // Production domain (hub.<domain>, hub-dev.<domain>, …)
+    { find: /slimbouchoucha\.tn/g, replace: domain },
+    // GHCR image prefix — owner unknown at scaffold time, leave a placeholder
+    {
+      find: /ghcr\.io\/sb-slim\/react-app-starter/gi,
+      replace: `ghcr.io/your-gh-org/${name}`
+    },
+    // GitHub repo references
+    {
+      find: /SB-SLIM\/react-app-starter/g,
+      replace: `your-gh-org/${name}`
+    },
+    // Remaining bare repo name (URLs, image names)
+    { find: /react-app-starter/g, replace: name },
+    // VPS IP
+    { find: /152\.53\.187\.54/g, replace: "YOUR_VPS_IP" },
+    // Notion page id (mirror of architecture docs — project specific)
+    { find: NOTION_PAGE_ID_DASHED, replace: "YOUR_NOTION_PAGE_ID" },
+    { find: NOTION_PAGE_ID_COMPACT, replace: "YOUR_NOTION_PAGE_ID" }
+  ];
+}
+var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".json",
+  ".md",
+  ".yml",
+  ".yaml",
+  ".css",
+  ".html",
+  ".example",
+  ".env"
+]);
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  ".turbo",
+  ".next",
+  "build"
+]);
+
+// src/index.ts
+var TEMPLATE = "github:SB-SLIM/react-app-starter";
+function bail(message) {
+  cancel(message);
+  process.exit(1);
+}
+function slugify(input) {
+  return input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function parseFlags(argv) {
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg || !arg.startsWith("--")) continue;
+    const eq = arg.indexOf("=");
+    if (eq !== -1) {
+      flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+    } else {
+      const key = arg.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith("--")) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = true;
+      }
+    }
+  }
+  return flags;
+}
+function collectTextFiles(dir, acc = []) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      collectTextFiles(join(dir, entry.name), acc);
+    } else if (entry.isFile()) {
+      const name = entry.name;
+      if (TEXT_EXTENSIONS.has(extname(name)) || name.startsWith(".env")) {
+        acc.push(join(dir, name));
+      }
+    }
+  }
+  return acc;
+}
+async function main() {
+  console.log();
+  intro(pc.bgCyan(pc.black(" create-sb-app ")));
+  const flags = parseFlags(process.argv.slice(2));
+  const positional = process.argv.slice(2).find((a) => !a.startsWith("--"));
+  let target = positional ?? (typeof flags.dir === "string" ? flags.dir : void 0);
+  if (!target) {
+    const answer = await text({
+      message: "Project directory?",
+      placeholder: "my-saas",
+      validate: (v) => v.length === 0 ? "Required" : void 0
+    });
+    if (isCancel(answer)) bail("Cancelled.");
+    target = answer;
+  }
+  const targetDir = join(process.cwd(), target);
+  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    bail(`Directory "${target}" already exists and is not empty.`);
+  }
+  let name;
+  if (typeof flags.name === "string") {
+    name = flags.name;
+  } else {
+    const nameAnswer = await text({
+      message: "Project name (package name)?",
+      initialValue: slugify(basename(target)),
+      validate: (v) => slugify(v).length === 0 ? "Invalid name" : void 0
+    });
+    if (isCancel(nameAnswer)) bail("Cancelled.");
+    name = nameAnswer;
+  }
+  let domain;
+  if (typeof flags.domain === "string") {
+    domain = flags.domain;
+  } else {
+    const domainAnswer = await text({
+      message: "Production domain?",
+      placeholder: "myapp.com",
+      defaultValue: "example.com"
+    });
+    if (isCancel(domainAnswer)) bail("Cancelled.");
+    domain = domainAnswer || "example.com";
+  }
+  let doGit;
+  if (flags.git === true || flags["no-git"] === true) {
+    doGit = flags.git === true;
+  } else {
+    const gitAnswer = await confirm({ message: "Initialize a fresh git repo?" });
+    if (isCancel(gitAnswer)) bail("Cancelled.");
+    doGit = gitAnswer;
+  }
+  const answers = {
+    name: slugify(name),
+    domain: domain.trim()
+  };
+  const s = spinner();
+  s.start("Downloading template");
+  try {
+    await downloadTemplate(TEMPLATE, { dir: targetDir, forceClean: true });
+  } catch (err) {
+    s.stop("Download failed");
+    bail(err instanceof Error ? err.message : String(err));
+  }
+  s.stop("Template downloaded");
+  const selfDir = join(targetDir, "packages", "create-sb-app");
+  if (existsSync(selfDir)) rmSync(selfDir, { recursive: true, force: true });
+  const gitDir = join(targetDir, ".git");
+  if (existsSync(gitDir)) rmSync(gitDir, { recursive: true, force: true });
+  const lockfile = join(targetDir, "pnpm-lock.yaml");
+  if (existsSync(lockfile)) rmSync(lockfile, { force: true });
+  s.start("Personalizing project");
+  const replacements = buildReplacements(answers);
+  for (const file of collectTextFiles(targetDir)) {
+    let content = readFileSync(file, "utf8");
+    let changed = false;
+    for (const { find, replace } of replacements) {
+      if (find.test(content)) {
+        content = content.replace(find, replace);
+        changed = true;
+      }
+    }
+    if (changed) writeFileSync(file, content);
+  }
+  const rootPkgPath = join(targetDir, "package.json");
+  if (existsSync(rootPkgPath)) {
+    const pkg = JSON.parse(readFileSync(rootPkgPath, "utf8"));
+    pkg.name = answers.name;
+    writeFileSync(rootPkgPath, JSON.stringify(pkg, null, 2) + "\n");
+  }
+  const envExample = join(targetDir, ".env.example");
+  const envFile = join(targetDir, ".env");
+  if (existsSync(envExample) && !existsSync(envFile)) {
+    copyFileSync(envExample, envFile);
+  }
+  s.stop("Project personalized");
+  if (doGit) {
+    try {
+      execSync("git init", { cwd: targetDir, stdio: "ignore" });
+      execSync("git add -A", { cwd: targetDir, stdio: "ignore" });
+    } catch {
+    }
+  }
+  note(
+    [
+      pc.bold("apps/"),
+      "  admin    React 19 + Vite + Tailwind v4 + TanStack Router/Query",
+      "  server   Fastify 5 + tRPC v11 + Pino (stateless API)",
+      "  web      Next.js 15 marketing site",
+      "  e2e      Playwright",
+      pc.bold("packages/  (@sb-codex/* plugins, workspace:^)"),
+      "  core \xB7 config \xB7 db \xB7 auth \xB7 api-contracts \xB7 jobs \xB7 ui-components",
+      pc.bold("infra/"),
+      "  docker \xB7 compose \xB7 traefik",
+      "",
+      pc.dim("Multi-tenant: Postgres + RLS, x-workspace-slug header."),
+      pc.dim("Docs: docs/architecture.md \xB7 docs/roadmap.md \xB7 docs/plugins/")
+    ].join("\n"),
+    "Architecture"
+  );
+  note(
+    [
+      `cd ${target}`,
+      "pnpm install",
+      "# .env already created from .env.example \u2014 fill the secrets",
+      "pnpm dev"
+    ].join("\n"),
+    "Next steps"
+  );
+  outro(pc.green(`Created ${pc.bold(answers.name)} \u{1F389}`));
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@sb-codex/create-sb-app",
+  "version": "0.0.1",
+  "description": "Scaffold a new multi-tenant SaaS project from the sb-codex starter.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Slim Bouchoucha",
+  "keywords": [
+    "sb-codex",
+    "saas-starter",
+    "create",
+    "scaffold",
+    "cli",
+    "template"
+  ],
+  "homepage": "https://github.com/SB-SLIM/react-app-starter/tree/main/packages/create-sb-app#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SB-SLIM/react-app-starter.git",
+    "directory": "packages/create-sb-app"
+  },
+  "bugs": "https://github.com/SB-SLIM/react-app-starter/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "create-sb-app": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "giget": "^1.2.1",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.5.0"
+  },
+  "scripts": {
+    "clean": "premove ./dist",
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}