@sb-codex/create-sb-app 0.0.1 → 0.0.3

package/README.md

@@ -1,40 +1,52 @@
 # @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.
+Scaffold a new multi-tenant SaaS project from the [sb-codex starter](https://github.com/SB-SLIM/react-app-starter).
+
+It generates an **apps-only** project: you get `apps/` (admin, server, web, e2e) and the `@sb-codex/*` plugins are pulled from **npm** at their published versions — there is **no `packages/` folder** to maintain. The CLI also injects each plugin's peer dependencies into the consuming apps so the project installs cleanly.
 
 ## Usage
 
 ```bash
-pnpm create @sb-codex/sb-app my-saas
-# or: npm create @sb-codex/sb-app my-saas
+pnpm create @sb-codex/sb-app@latest my-saas
+# or: npm create @sb-codex/sb-app@latest my-saas
 ```
 
+> The `@latest` tag forces the newest version and avoids npx serving a cached older release.
+
 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
+- **Production domain** — replaces the reference domain. **Defaults to `localhost`** for local dev (e.g. `hub.localhost`)
 - **git init** — start with fresh git history
 
 Then:
 
 ```bash
 cd my-saas
-pnpm install
+pnpm install     # plugins resolved from npm — no local build
 pnpm dev
 ```
 
-## What it replaces
+## What it does
+
+- Pulls `apps/` from the starter; rewrites each `@sb-codex/*` dependency from `workspace:^` to the **published npm version** and injects that plugin's peer dependencies
+- Removes the `packages/` source, trims `pnpm-workspace.yaml` to `apps/*`, strips `@sb-codex/*` from `pnpm.overrides`, drops the changeset config
+- Copies `.env.example` → `.env`
+- Replaces project-specific tokens:
 
-| 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`        |
+| Token                               | Replaced with                     |
+| ----------------------------------- | --------------------------------- |
+| `slimbouchoucha.tn`                 | your domain (default `localhost`) |
+| `ghcr.io/sb-slim/react-app-starter` | `ghcr.io/your-gh-org/<name>`      |
+| `SB-SLIM/react-app-starter`         | `your-gh-org/<name>`              |
+| 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`.
+## Non-interactive flags
+
+```bash
+npx @sb-codex/create-sb-app my-saas --name my-saas --domain localhost --no-git
+```
 
 ## Local usage (from the monorepo)
 

package/dist/index.js

@@ -2,14 +2,14 @@
 
 // src/index.ts
 import {
-  existsSync,
-  readdirSync,
-  readFileSync,
-  writeFileSync,
-  rmSync,
+  existsSync as existsSync2,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync2,
+  writeFileSync as writeFileSync2,
+  rmSync as rmSync2,
   copyFileSync
 } from "fs";
-import { join, extname, basename } from "path";
+import { join as join2, extname, basename } from "path";
 import { execSync } from "child_process";
 import {
   intro,
@@ -44,8 +44,6 @@ function buildReplacements(answers) {
     },
     // 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" }
@@ -76,6 +74,87 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
   "build"
 ]);
 
+// src/transform.ts
+import {
+  existsSync,
+  readFileSync,
+  writeFileSync,
+  rmSync,
+  readdirSync
+} from "fs";
+import { join } from "path";
+function readJson(path) {
+  return JSON.parse(readFileSync(path, "utf8"));
+}
+function writeJson(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
+}
+function applyAppsOnly(targetDir) {
+  const packagesDir = join(targetDir, "packages");
+  const pkgMap = /* @__PURE__ */ new Map();
+  if (existsSync(packagesDir)) {
+    for (const entry of readdirSync(packagesDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const pj = join(packagesDir, entry.name, "package.json");
+      if (!existsSync(pj)) continue;
+      const pkg = readJson(pj);
+      const name = pkg.name;
+      if (typeof name === "string" && name.startsWith("@sb-codex/")) {
+        pkgMap.set(name, {
+          version: String(pkg.version ?? "0.0.0"),
+          peerDependencies: pkg.peerDependencies ?? {}
+        });
+      }
+    }
+  }
+  const appsDir = join(targetDir, "apps");
+  if (existsSync(appsDir)) {
+    for (const entry of readdirSync(appsDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const pj = join(appsDir, entry.name, "package.json");
+      if (!existsSync(pj)) continue;
+      const pkg = readJson(pj);
+      const deps = pkg.dependencies ?? {};
+      const devDeps = pkg.devDependencies ?? {};
+      let changed = false;
+      for (const depName of Object.keys(deps)) {
+        const info = pkgMap.get(depName);
+        if (!info) continue;
+        deps[depName] = `^${info.version}`;
+        changed = true;
+        for (const [peer, range] of Object.entries(info.peerDependencies)) {
+          if (!deps[peer] && !devDeps[peer]) deps[peer] = range;
+        }
+      }
+      if (changed) {
+        pkg.dependencies = deps;
+        writeJson(pj, pkg);
+      }
+    }
+  }
+  if (existsSync(packagesDir))
+    rmSync(packagesDir, { recursive: true, force: true });
+  const wsPath = join(targetDir, "pnpm-workspace.yaml");
+  if (existsSync(wsPath)) {
+    const kept = readFileSync(wsPath, "utf8").split(/\r?\n/).filter((line) => !/['"]packages\/\*['"]/.test(line)).join("\n");
+    writeFileSync(wsPath, kept);
+  }
+  const rootPj = join(targetDir, "package.json");
+  if (existsSync(rootPj)) {
+    const pkg = readJson(rootPj);
+    const pnpm = pkg.pnpm;
+    if (pnpm?.overrides) {
+      for (const key of Object.keys(pnpm.overrides)) {
+        if (key.startsWith("@sb-codex/")) delete pnpm.overrides[key];
+      }
+    }
+    writeJson(rootPj, pkg);
+  }
+  const changesetDir = join(targetDir, ".changeset");
+  if (existsSync(changesetDir))
+    rmSync(changesetDir, { recursive: true, force: true });
+}
+
 // src/index.ts
 var TEMPLATE = "github:SB-SLIM/react-app-starter";
 function bail(message) {
@@ -107,14 +186,14 @@ function parseFlags(argv) {
   return flags;
 }
 function collectTextFiles(dir, acc = []) {
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync2(dir, { withFileTypes: true })) {
     if (entry.isDirectory()) {
       if (SKIP_DIRS.has(entry.name)) continue;
-      collectTextFiles(join(dir, entry.name), acc);
+      collectTextFiles(join2(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));
+        acc.push(join2(dir, name));
       }
     }
   }
@@ -135,8 +214,8 @@ async function main() {
     if (isCancel(answer)) bail("Cancelled.");
     target = answer;
   }
-  const targetDir = join(process.cwd(), target);
-  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+  const targetDir = join2(process.cwd(), target);
+  if (existsSync2(targetDir) && readdirSync2(targetDir).length > 0) {
     bail(`Directory "${target}" already exists and is not empty.`);
   }
   let name;
@@ -156,12 +235,12 @@ async function main() {
     domain = flags.domain;
   } else {
     const domainAnswer = await text({
-      message: "Production domain?",
-      placeholder: "myapp.com",
-      defaultValue: "example.com"
+      message: "Production domain? (defaults to localhost for local dev)",
+      placeholder: "localhost",
+      defaultValue: "localhost"
     });
     if (isCancel(domainAnswer)) bail("Cancelled.");
-    domain = domainAnswer || "example.com";
+    domain = domainAnswer || "localhost";
   }
   let doGit;
   if (flags.git === true || flags["no-git"] === true) {
@@ -184,16 +263,15 @@ async function main() {
     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 });
+  applyAppsOnly(targetDir);
+  const gitDir = join2(targetDir, ".git");
+  if (existsSync2(gitDir)) rmSync2(gitDir, { recursive: true, force: true });
+  const lockfile = join2(targetDir, "pnpm-lock.yaml");
+  if (existsSync2(lockfile)) rmSync2(lockfile, { force: true });
   s.start("Personalizing project");
   const replacements = buildReplacements(answers);
   for (const file of collectTextFiles(targetDir)) {
-    let content = readFileSync(file, "utf8");
+    let content = readFileSync2(file, "utf8");
     let changed = false;
     for (const { find, replace } of replacements) {
       if (find.test(content)) {
@@ -201,17 +279,17 @@ async function main() {
         changed = true;
       }
     }
-    if (changed) writeFileSync(file, content);
+    if (changed) writeFileSync2(file, content);
   }
-  const rootPkgPath = join(targetDir, "package.json");
-  if (existsSync(rootPkgPath)) {
-    const pkg = JSON.parse(readFileSync(rootPkgPath, "utf8"));
+  const rootPkgPath = join2(targetDir, "package.json");
+  if (existsSync2(rootPkgPath)) {
+    const pkg = JSON.parse(readFileSync2(rootPkgPath, "utf8"));
     pkg.name = answers.name;
-    writeFileSync(rootPkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    writeFileSync2(rootPkgPath, JSON.stringify(pkg, null, 2) + "\n");
   }
-  const envExample = join(targetDir, ".env.example");
-  const envFile = join(targetDir, ".env");
-  if (existsSync(envExample) && !existsSync(envFile)) {
+  const envExample = join2(targetDir, ".env.example");
+  const envFile = join2(targetDir, ".env");
+  if (existsSync2(envExample) && !existsSync2(envFile)) {
     copyFileSync(envExample, envFile);
   }
   s.stop("Project personalized");
@@ -229,13 +307,13 @@ async function main() {
       "  server   Fastify 5 + tRPC v11 + Pino (stateless API)",
       "  web      Next.js 15 marketing site",
       "  e2e      Playwright",
-      pc.bold("packages/  (@sb-codex/* plugins, workspace:^)"),
+      pc.bold("@sb-codex/* plugins (from npm)"),
       "  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/")
+      pc.dim("Plugins resolved from npm \u2014 no packages/ folder.")
     ].join("\n"),
     "Architecture"
   );

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@sb-codex/create-sb-app",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Scaffold a new multi-tenant SaaS project from the sb-codex starter.",
   "type": "module",
   "license": "MIT",