@thinhnguyencth1204/nextcli 0.7.0 → 0.9.0

package/README.md

@@ -17,7 +17,7 @@ node dist/cli.js --help
 
 ## Command: create
 
-Create a new project from the minimal base template:
+Create a new project from the full-stack base template:
 
 ```bash
 node dist/cli.js create
@@ -27,36 +27,48 @@ This command is fully interactive:
 
 - enter project name
 - select package manager in CLI UI (`npm`, `pnpm`, `yarn`, `bun`)
-- multi-select optional modules (see module list below)
+- multi-select optional modules (`chat`, `supabase-realtime`, `seo`, `email`)
 - confirm install step
 - normalizes project directory name into a safe project slug for generated `package.json` and env placeholders
 - ships `SETUP.md` and `PROJECT_STRUCTURE.md` in the generated project root
 
-**Default output is minimal:** Next.js shell, branding, theme, and UI primitives only. Database, auth, dashboard, and other stacks are added only when selected.
+**Default output includes:** Prisma + Postgres, Supabase client + Storage, Better Auth + RBAC, API client (Axios + React Query), i18n (next-intl), dashboard shell, example CRUD demo, branding, theme, UI primitives, and Lexical rich text adapters. Optional modules are added only when selected.
 
-## Optional modules
+## Rich text (base)
 
-Available during `create` and `add module`:
+All generated projects include Lexical rich text building blocks:
 
-| Module              | Adds                                                          |
-| ------------------- | ------------------------------------------------------------- |
-| `database`          | Prisma schema, client, `DATABASE_URL`, db scripts             |
-| `supabase`          | Supabase browser client + Storage helpers                     |
-| `auth`              | Better Auth, sign-in pages, user APIs, bootstrap admin        |
-| `api`               | Axios client, API envelope helpers, React Query provider      |
-| `i18n`              | next-intl config, messages, locale switcher (auto-adds `api`) |
-| `dashboard`         | Protected dashboard shell, sidebar, data-table UI             |
-| `example`           | Starter CRUD demo + `Example` Prisma model                    |
-| `chat`              | Chat routes, hooks, Prisma chat models (+ auto deps)          |
-| `supabase-realtime` | Realtime channel helpers (+ auto `supabase`)                  |
-| `seo`               | robots/sitemap/JSON-LD helpers                                |
-| `email`             | Email helper + React Email templates (SMTP or Resend)         |
+- `EditorField` — swappable `textarea` or `lexical` adapter for forms
+- `RichTextRenderer` — read-only playback of Lexical JSON from API data
+- Toolbar: bold/italic/underline, emoji picker, image URL insertion
+- Demo page: `/blog-demo`
 
-Module dependencies are auto-added (e.g. `auth` → `database`, `dashboard` → `auth` + `api` + `i18n`, `chat` → `database` + `supabase-realtime` + `supabase`).
+Lexical content is stored as JSON (`SerializedEditorState`). Supabase-managed image URLs trigger storage cleanup via `syncRemovedSupabaseRichTextImages` (included in base).
 
-## Auth module (`auth`)
+**Included in every project (base):**
 
-When selected, generated projects include:
+| Module      | Adds                                                     |
+| ----------- | -------------------------------------------------------- |
+| `database`  | Prisma schema, client, `DATABASE_URL`, db scripts        |
+| `supabase`  | Supabase browser client + Storage helpers                |
+| `auth`      | Better Auth, sign-in pages, user APIs, bootstrap admin   |
+| `api`       | Axios client, API envelope helpers, React Query provider |
+| `i18n`      | next-intl config, messages, locale switcher              |
+| `dashboard` | Protected dashboard shell, sidebar, data-table UI        |
+| `example`   | Starter CRUD demo + `Example` Prisma model               |
+
+**Optional** during `create` and `add module`:
+
+| Module              | Adds                                                                |
+| ------------------- | ------------------------------------------------------------------- |
+| `chat`              | Chat routes, hooks, Prisma chat models (+ auto `supabase-realtime`) |
+| `supabase-realtime` | Realtime channel helpers                                            |
+| `seo`               | robots/sitemap/JSON-LD helpers                                      |
+| `email`             | Email helper + React Email templates (SMTP or Resend)               |
+
+## Auth (base)
+
+Every generated project includes:
 
 - Better Auth + Prisma adapter with JWT + username plugins
 - username/password sign-in (`/sign-in`) and forced password change (`/change-password`)
@@ -70,7 +82,7 @@ When selected, generated projects include:
   - `GET /api/v1/auth/me`
   - `POST /api/v1/auth/change-password`
 
-Axios setup (`api` module):
+Axios setup (included in base):
 
 - `publicApi`: public calls
 - `protectedApi`: bearer token calls with 401 refresh queue + retry
@@ -85,12 +97,12 @@ Project-owned routes under `/api/v1/*` use a unified envelope:
 - Error:
   - `{ success: false, error: { code, message, details? }, timestamp, requestId? }`
 
-This is powered by `src/lib/api/response.ts` when the `api` module is enabled.
+This is powered by `src/lib/api/response.ts` (included in base).
 The Better Auth passthrough route `/api/auth/[...all]` remains unwrapped.
 
 ## Command: add feature
 
-Run inside a generated project root (requires `database` and `api` for full CRUD wiring):
+Run inside a generated project root (database and api are included in base):
 
 ```bash
 node ../dist/cli.js add feature orders
@@ -174,6 +186,7 @@ Optional flags:
 - shadcn-style shared UI folder (base)
 - Zod validation (base)
 - Sonner notifications (base)
+- Lexical rich text editor + renderer (base)
 - Optional: chat, supabase-realtime, seo, email
 
 ## Template structure

package/dist/cli.js

@@ -152,17 +152,40 @@ async function mergeEnvFile(envFilePath, entries, options = {}) {
       existingKeys.add(key.trim());
     }
   }
+  let nextLines = [...lines];
   const additions = [];
   for (const [key, value] of Object.entries(entries)) {
+    if (options.overwrite && existingKeys.has(key)) {
+      nextLines = nextLines.map((line) => {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+          return line;
+        }
+        const [lineKey] = trimmed.split("=");
+        if (lineKey?.trim() === key) {
+          return `${key}=${formatEnvValue(value)}`;
+        }
+        return line;
+      });
+      continue;
+    }
     if (!existingKeys.has(key)) {
       additions.push(`${key}=${formatEnvValue(value)}`);
     }
   }
+  let content = currentContent;
+  if (options.overwrite) {
+    content = `${nextLines.join("\n").replace(/\n?$/, "\n")}`;
+    if (additions.length === 0) {
+      await writeFile(envFilePath, content, "utf8");
+      return;
+    }
+  }
   if (additions.length === 0) {
     return;
   }
-  if (options.header && currentContent.includes(options.header)) {
-    const nextContent2 = currentContent.replace(
+  if (options.header && content.includes(options.header)) {
+    const nextContent2 = content.replace(
       options.header,
       `${options.header}
 ${additions.join("\n")}`
@@ -173,8 +196,8 @@ ${additions.join("\n")}`
   if (options.header) {
     additions.unshift(options.header);
   }
-  const separator = currentContent.endsWith("\n") || currentContent.length === 0 ? "" : "\n";
-  const nextContent = `${currentContent}${separator}${additions.join("\n")}
+  const separator = content.endsWith("\n") || content.length === 0 ? "" : "\n";
+  const nextContent = `${content}${separator}${additions.join("\n")}
 `;
   await writeFile(envFilePath, nextContent, "utf8");
 }
@@ -382,53 +405,6 @@ function getEmailProviderDependencies(provider) {
   };
 }
 
-// src/core/module-selection.ts
-var MODULE_ORDER = [
-  "database",
-  "supabase",
-  "auth",
-  "api",
-  "i18n",
-  "dashboard",
-  "example",
-  "supabase-realtime",
-  "chat",
-  "seo",
-  "email"
-];
-var MODULE_DEPENDENCIES = {
-  auth: ["database"],
-  i18n: ["api"],
-  dashboard: ["auth", "api", "i18n"],
-  example: ["dashboard", "database"],
-  chat: ["database", "supabase-realtime"],
-  "supabase-realtime": ["supabase"]
-};
-function sortModules(moduleIds) {
-  const set = new Set(moduleIds);
-  return MODULE_ORDER.filter((id) => set.has(id));
-}
-function normalizeModuleSelection(moduleIds) {
-  const requested = new Set(moduleIds);
-  const autoAdded = [];
-  function addDependencies(moduleId) {
-    for (const dep of MODULE_DEPENDENCIES[moduleId] ?? []) {
-      if (!requested.has(dep)) {
-        requested.add(dep);
-        autoAdded.push(dep);
-        addDependencies(dep);
-      }
-    }
-  }
-  for (const moduleId of moduleIds) {
-    addDependencies(moduleId);
-  }
-  return {
-    selectedModules: sortModules([...requested]),
-    autoAddedModules: autoAdded
-  };
-}
-
 // src/core/templates.ts
 import path4 from "path";
 import { existsSync } from "fs";
@@ -453,7 +429,22 @@ var templatePaths = {
 };
 
 // src/core/modules.ts
-var optionalModules = [
+var baseModuleIds = [
+  "database",
+  "supabase",
+  "auth",
+  "api",
+  "i18n",
+  "dashboard",
+  "example"
+];
+var optionalModuleIds = [
+  "chat",
+  "supabase-realtime",
+  "seo",
+  "email"
+];
+var moduleDefinitions = [
   {
     id: "database",
     label: "Database (Prisma + Postgres)",
@@ -523,7 +514,7 @@ Create the bucket and RLS policies in Supabase Dashboard before uploads.`
 | \`BETTER_AUTH_SECRET\` | Auto-generated on create; rotate in production |
 | \`BETTER_AUTH_URL\` | Your app URL (e.g. \`http://localhost:3000\`) |
 
-Requires \`database\` (auto-added). Bootstrap seeds \`admin\` / \`admin1234\` on first dev start.`
+Requires \`database\` (included in base). Bootstrap seeds \`admin\` / \`admin1234\` on first dev start.`
   },
   {
     id: "api",
@@ -567,7 +558,7 @@ Add more locales with \`nextcli add language\`.`
       nuqs: "^2.8.1",
       "date-fns": "^3.6.0"
     },
-    setupSection: `Requires \`auth\`, \`api\`, and \`i18n\` (auto-added). Protected routes redirect unauthenticated users to \`/sign-in\`.`
+    setupSection: `Requires \`auth\`, \`api\`, and \`i18n\` (included in base). Protected routes redirect unauthenticated users to \`/sign-in\`.`
   },
   {
     id: "example",
@@ -575,7 +566,7 @@ Add more locales with \`nextcli add language\`.`
     description: "Adds starter example feature with API route, hooks, and Prisma model",
     templatePath: templatePaths.example,
     env: {},
-    setupSection: `Requires \`dashboard\` and \`database\` (auto-added). Appends \`Example\` model to \`prisma/schema.prisma\` \u2014 run \`db:migrate\` after add.`
+    setupSection: `Requires \`dashboard\` and \`database\` (included in base). Includes demo \`Example\` model in \`prisma/schema.prisma\` \u2014 run \`db:migrate\` after create.`
   },
   {
     id: "chat",
@@ -589,7 +580,7 @@ Add more locales with \`nextcli add language\`.`
 | -------- | ------------ |
 | \`NEXT_PUBLIC_ENABLE_CHAT\` | Set \`true\` when chat module is enabled (auto on add) |
 
-Requires \`database\`, \`supabase\`, and \`supabase-realtime\` (auto-added). Run \`db:migrate\` after add \u2014 chat Prisma models are appended.`
+Requires \`database\`, \`supabase\`, and \`supabase-realtime\` (base includes database/supabase; realtime auto-added). Run \`db:migrate\` after add \u2014 chat Prisma models are appended.`
   },
   {
     id: "supabase-realtime",
@@ -598,7 +589,7 @@ Requires \`database\`, \`supabase\`, and \`supabase-realtime\` (auto-added). Run
     templatePath: templatePaths.supabaseRealtime,
     env: {},
     dependencies: {},
-    setupSection: `Requires \`supabase\` (auto-added). Enable Realtime on tables in Supabase Dashboard \u2192 Database \u2192 Replication.`
+    setupSection: `Requires \`supabase\` (included in base). Enable Realtime on tables in Supabase Dashboard \u2192 Database \u2192 Replication.`
   },
   {
     id: "seo",
@@ -622,13 +613,58 @@ Requires \`database\`, \`supabase\`, and \`supabase-realtime\` (auto-added). Run
 Only the selected provider keys are merged into your env files.`
   }
 ];
+var optionalModules = moduleDefinitions.filter(
+  (module) => optionalModuleIds.includes(module.id)
+);
 function getModuleById(moduleId) {
-  const module = optionalModules.find((item) => item.id === moduleId);
+  const module = moduleDefinitions.find((item) => item.id === moduleId);
   if (!module) {
-    throw new Error(`Unknown optional module: ${moduleId}`);
+    throw new Error(`Unknown module: ${moduleId}`);
   }
   return module;
 }
+function isBaseModuleId(moduleId) {
+  return baseModuleIds.includes(moduleId);
+}
+function isOptionalModuleId(moduleId) {
+  return optionalModuleIds.includes(moduleId);
+}
+
+// src/core/module-selection.ts
+var MODULE_ORDER = [
+  ...baseModuleIds,
+  "supabase-realtime",
+  "chat",
+  "seo",
+  "email"
+];
+var MODULE_DEPENDENCIES = {
+  chat: ["supabase-realtime"]
+};
+function sortModules(moduleIds) {
+  const set = new Set(moduleIds);
+  return MODULE_ORDER.filter((id) => set.has(id));
+}
+function normalizeModuleSelection(moduleIds) {
+  const requested = /* @__PURE__ */ new Set([...baseModuleIds, ...moduleIds]);
+  const autoAdded = [];
+  function addDependencies(moduleId) {
+    for (const dep of MODULE_DEPENDENCIES[moduleId] ?? []) {
+      if (!requested.has(dep)) {
+        requested.add(dep);
+        autoAdded.push(dep);
+        addDependencies(dep);
+      }
+    }
+  }
+  for (const moduleId of moduleIds) {
+    addDependencies(moduleId);
+  }
+  return {
+    selectedModules: sortModules([...requested]),
+    autoAddedModules: autoAdded
+  };
+}
 
 // src/core/setup-docs.ts
 import { readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
@@ -721,12 +757,28 @@ function resolveModuleEnv(moduleId, emailProvider, authSecret) {
   }
   return env;
 }
+async function mergeAuthSecret(projectDir, authSecret) {
+  const envTargets = [".env", ".env.example", ".env.development"];
+  for (const envFile of envTargets) {
+    const envPath = path6.join(projectDir, envFile);
+    if (await pathExists(envPath)) {
+      await mergeEnvFile(
+        envPath,
+        { BETTER_AUTH_SECRET: authSecret },
+        { header: "# --- module: auth ---", overwrite: true }
+      );
+    }
+  }
+}
 async function applyModulesToProject(options) {
   const { projectDir, moduleIds, emailProvider, safeCopy = false } = options;
   const authSecret = options.authSecret ?? randomBytes(32).toString("base64url");
   const { selectedModules, autoAddedModules } = normalizeModuleSelection(moduleIds);
   const copyReports = [];
-  for (const moduleId of selectedModules) {
+  const modulesToCopy = selectedModules.filter(
+    (moduleId) => !baseModuleIds.includes(moduleId)
+  );
+  for (const moduleId of modulesToCopy) {
     const module = getModuleById(moduleId);
     if (safeCopy) {
       copyReports.push({
@@ -742,11 +794,12 @@ async function applyModulesToProject(options) {
     chatSchemaStatus = await ensureChatSchemaInProject(projectDir);
   }
   let exampleSchemaStatus;
-  if (selectedModules.includes("example")) {
+  if (selectedModules.includes("example") && modulesToCopy.includes("example")) {
     exampleSchemaStatus = await ensureExampleSchemaInProject(projectDir);
   }
   const envTargets = [".env", ".env.example", ".env.development"];
-  for (const moduleId of selectedModules) {
+  const envModules = ["auth", ...modulesToCopy];
+  for (const moduleId of envModules) {
     const moduleEnv = resolveModuleEnv(moduleId, emailProvider, authSecret);
     if (Object.keys(moduleEnv).length === 0) {
       continue;
@@ -761,11 +814,11 @@ async function applyModulesToProject(options) {
     }
   }
   const packageJsonPath = path6.join(projectDir, "package.json");
-  if (await pathExists(packageJsonPath)) {
+  if (await pathExists(packageJsonPath) && modulesToCopy.length > 0) {
     const dependencies = {};
     const devDependencies = {};
     const scripts = {};
-    for (const moduleId of selectedModules) {
+    for (const moduleId of modulesToCopy) {
       const module = getModuleById(moduleId);
       Object.assign(dependencies, module.dependencies ?? {});
       Object.assign(devDependencies, module.devDependencies ?? {});
@@ -811,12 +864,20 @@ import { readdir as readdir3, readFile as readFile6, writeFile as writeFile6 } f
 import path7 from "path";
 import { readdir as readdir2, readFile as readFile5, writeFile as writeFile5 } from "fs/promises";
 var defaultManifest = {
-  cli: "0.7.0",
+  cli: "0.9.0",
   defaultLocale: "vi",
-  locales: [],
-  namespaces: [],
-  modules: [],
-  features: []
+  locales: ["vi"],
+  namespaces: ["common", "auth", "example"],
+  modules: [
+    "database",
+    "supabase",
+    "auth",
+    "api",
+    "i18n",
+    "dashboard",
+    "example"
+  ],
+  features: ["example"]
 };
 function getManifestPath(projectDir) {
   return path7.join(projectDir, "nextcli.json");
@@ -1756,7 +1817,9 @@ function registerAddCommand(program2) {
         );
       } else if (result.reason === "already-exists") {
         const slug = featureName.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-");
-        log.error(`Feature already exists: ${path10.join(cwd, "src/features", slug)}`);
+        log.error(
+          `Feature already exists: ${path10.join(cwd, "src/features", slug)}`
+        );
       }
       process.exitCode = 1;
       return;
@@ -1785,9 +1848,6 @@ function registerAddCommand(program2) {
         process.exitCode = 1;
         return;
       }
-      const validIds = new Set(
-        optionalModules.map((module) => module.id)
-      );
       const requestedValues = options.module ? options.module.flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean) : [];
       const requestedIds = [];
       let emailProviderFromModuleAlias;
@@ -1798,14 +1858,6 @@ function registerAddCommand(program2) {
         return;
       }
       for (const moduleId of requestedValues) {
-        if (validIds.has(moduleId)) {
-          requestedIds.push(moduleId);
-          continue;
-        }
-        if (moduleId === "supabase") {
-          requestedIds.push("supabase");
-          continue;
-        }
         if (moduleId === "resend") {
           log.info(
             "Module 'resend' is now 'email'; selecting email with provider resend."
@@ -1814,11 +1866,18 @@ function registerAddCommand(program2) {
           emailProviderFromModuleAlias = "resend";
           continue;
         }
-        if (!validIds.has(moduleId)) {
-          log.error(`Unknown module: ${moduleId}`);
+        if (!isOptionalModuleId(moduleId)) {
+          if (isBaseModuleId(moduleId)) {
+            log.error(
+              `Module '${moduleId}' is included in the base template and cannot be added separately.`
+            );
+          } else {
+            log.error(`Unknown module: ${moduleId}`);
+          }
           process.exitCode = 1;
           return;
         }
+        requestedIds.push(moduleId);
       }
       startPrompt("NexTCLI optional modules");
       const rawModules = requestedIds.length > 0 ? [...new Set(requestedIds)] : options.yes ? [] : await askMultiSelect(
@@ -1872,15 +1931,18 @@ function registerAddCommand(program2) {
       }
       const state = await detectProjectState(cwd);
       const modulesToInstall = selectedModules.filter(
-        (moduleId) => !state.modules.includes(moduleId)
+        (moduleId) => !state.modules.includes(moduleId) && !baseModuleIds.includes(moduleId)
       );
       if (modulesToInstall.length === 0) {
         finishPrompt("Selected modules are already installed.");
         return;
       }
+      const optionalToApply = rawModules.length > 0 ? rawModules : modulesToInstall.filter(
+        (moduleId) => isOptionalModuleId(moduleId)
+      );
       const applyResult = await applyModulesToProject({
         projectDir: cwd,
-        moduleIds: rawModules.length > 0 ? rawModules : selectedModules,
+        moduleIds: optionalToApply,
         emailProvider,
         safeCopy: true
       });
@@ -1927,7 +1989,7 @@ function registerAddCommand(program2) {
         ...state,
         namespaces: [...namespaceSet],
         modules: mergedModules,
-        locales: mergedModules.includes("i18n") ? [.../* @__PURE__ */ new Set([...state.locales, "vi"])] : state.locales,
+        locales: state.locales.length > 0 ? state.locales : ["vi"],
         features: mergedModules.includes("example") ? [.../* @__PURE__ */ new Set([...state.features, "example"])] : state.features
       });
       await mergeModuleDocs(cwd, modulesToInstall, mergedModules);
@@ -2111,9 +2173,10 @@ function registerAddCommand(program2) {
 }
 
 // src/commands/create.ts
+import { randomBytes as randomBytes2 } from "crypto";
 import { spawn as spawn2 } from "child_process";
 import path11 from "path";
-var CLI_VERSION = "0.7.0";
+var CLI_VERSION = "0.9.0";
 async function runInstall(packageManager, cwd) {
   const installArgsMap = {
     npm: ["install"],
@@ -2215,11 +2278,14 @@ function registerCreateCommand(program2) {
       );
     }
     const shouldInstall = await askConfirm("Install dependencies now?", true);
+    const authSecret = randomBytes2(32).toString("base64url");
     await copyDirectory(templatePaths.base, targetPath);
+    await mergeAuthSecret(targetPath, authSecret);
     const applyResult = await applyModulesToProject({
       projectDir: targetPath,
       moduleIds: rawModules,
-      emailProvider
+      emailProvider,
+      authSecret
     });
     await replaceTokensInDirectory(targetPath, {
       __PROJECT_NAME__: projectSlug,
@@ -2227,28 +2293,18 @@ function registerCreateCommand(program2) {
     });
     await mergeModuleDocs(
       targetPath,
-      applyResult.selectedModules,
+      [...baseModuleIds, ...rawModules],
       applyResult.selectedModules
     );
     const manifest = await readManifest(targetPath);
     if (manifest) {
-      const namespaces = [...manifest.namespaces];
-      if (applyResult.selectedModules.includes("i18n")) {
-        namespaces.push("common");
-      }
-      if (applyResult.selectedModules.includes("auth")) {
-        namespaces.push("auth");
-      }
-      if (applyResult.selectedModules.includes("example")) {
-        namespaces.push("example");
-      }
       await writeManifest(targetPath, {
         ...manifest,
         cli: CLI_VERSION,
         modules: applyResult.selectedModules,
-        namespaces: [...new Set(namespaces)],
-        locales: applyResult.selectedModules.includes("i18n") ? ["vi"] : manifest.locales,
-        features: applyResult.selectedModules.includes("example") ? ["example"] : manifest.features
+        namespaces: ["common", "auth", "example"],
+        locales: ["vi"],
+        features: ["example"]
       });
     }
     if (shouldInstall) {
@@ -2260,9 +2316,13 @@ function registerCreateCommand(program2) {
     if (projectSlug !== projectDirectoryName) {
       log.detail("Normalized project id", projectSlug);
     }
+    log.detail("Base modules", baseModuleIds.join(", "));
+    const optionalInstalled = applyResult.selectedModules.filter(
+      (moduleId) => !baseModuleIds.includes(moduleId)
+    );
     log.detail(
-      "Modules",
-      applyResult.selectedModules.length > 0 ? applyResult.selectedModules.join(", ") : "none"
+      "Optional modules",
+      optionalInstalled.length > 0 ? optionalInstalled.join(", ") : "none"
     );
     if (applyResult.autoAddedModules.length > 0) {
       log.detail("Auto-added", applyResult.autoAddedModules.join(", "));
@@ -2278,8 +2338,9 @@ function registerCreateCommand(program2) {
     if (applyResult.exampleSchemaStatus === "added") {
       log.info("Example model was appended to prisma/schema.prisma.");
     }
-    const nextStep = applyResult.selectedModules.includes("database") ? `cd ${projectName} && ${packageManager} run db:migrate && ${packageManager} run dev` : `cd ${projectName} && ${packageManager} run dev`;
-    log.step(`Next: ${nextStep}`);
+    log.step(
+      `Next: cd ${projectName} && ${packageManager} run db:migrate && ${packageManager} run dev`
+    );
   });
 }
 
@@ -2494,7 +2555,7 @@ var NexTCLICommand = class _NexTCLICommand extends Command {
 
 // src/cli.ts
 var program = new NexTCLICommand();
-program.name("nextcli").description("Scaffold outsource-ready Next.js projects").version("0.7.0");
+program.name("nextcli").description("Scaffold outsource-ready Next.js projects").version("0.9.0");
 registerCreateCommand(program);
 registerAddCommand(program);
 registerMigrateCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinhnguyencth1204/nextcli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "CLI scaffolder for outsourced Next.js projects",
   "type": "module",
   "bin": {
@@ -15,8 +15,9 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "test": "bun test src/core/add-feature.test.ts",
-    "test:add-feature": "bun run build && bun test src/core/add-feature.test.ts",
+    "test": "bun test tests",
+    "test:add-feature": "bun run build && bun test tests/core",
+    "test:rich-text": "bun test tests/templates/next-base",
     "smoke": "node dist/cli.js --help",
     "smoke:full": "bun run build && bun run test && bun run scripts/pre-publish-smoke.ts",
     "prepublishOnly": "npm run build"
@@ -40,6 +41,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.29",
+    "lexical": "^0.45.0",
     "tsup": "^8.1.0",
     "typescript": "^5.5.4"
   }

package/templates/features/supabase/src/lib/supabase/rich-text-image-sync.ts

@@ -0,0 +1,28 @@
+import { removeResource } from "@/lib/supabase/storage";
+import {
+  isSupabaseManagedImageUrl,
+  syncRemovedRichTextImages,
+  type RemoveManagedImageFn,
+} from "@/lib/rich-text";
+import type { SerializedEditorState } from "lexical";
+
+export const removeSupabaseManagedImage: RemoveManagedImageFn = async (
+  _url,
+  ref,
+) => {
+  await removeResource(ref.path, ref.bucket);
+};
+
+/**
+ * Deletes Supabase storage objects for images removed from rich text content.
+ * Only URLs belonging to this project's configured Supabase bucket are removed.
+ */
+export async function syncRemovedSupabaseRichTextImages(
+  previous: SerializedEditorState | null | undefined,
+  next: SerializedEditorState | null | undefined,
+) {
+  return syncRemovedRichTextImages(previous, next, {
+    isManagedUrl: isSupabaseManagedImageUrl,
+    removeManagedImage: removeSupabaseManagedImage,
+  });
+}