@thinhnguyencth1204/nextcli 0.1.0 → 0.2.0

package/README.md

@@ -20,29 +20,21 @@ node dist/cli.js --help
 Create a new project from the base template:
 
 ```bash
-node dist/cli.js create my-nextjs-app
+node dist/cli.js create
 ```
 
-This command is interactive by default:
+This command is fully interactive:
+
+- enter project name
 - select package manager in CLI UI (`npm`, `pnpm`, `yarn`, `bun`)
-- multi-select optional modules (`chat`, `supabase`, `supabase-realtime`, `seo`)
+- multi-select optional modules (`chat`, `supabase`, `supabase-realtime`, `seo`, `resend`)
 - confirm install step
 - normalizes project directory name into a safe project slug for generated `package.json` and env placeholders
 
-### Non-interactive create options (for CI/automation)
-
-- `--yes`: skip prompts and use defaults
-- `--package-manager <npm|pnpm|yarn|bun>`: set package manager explicitly
-- `--module <id...>`: preselect optional modules (repeat or comma-separated)
-- `--install` / `--no-install`: force install behavior
-
-```bash
-node dist/cli.js create my-nextjs-app --yes --module supabase --module seo --no-install
-```
-
 ## Core auth in base template
 
 Generated projects now include:
+
 - Better Auth + Prisma adapter with JWT plugin enabled
 - email/password sign-in scaffold (`/sign-in`)
 - account sample page (`/account`)
@@ -53,6 +45,7 @@ Generated projects now include:
   - `GET /api/v1/auth/me`
 
 Axios setup is split:
+
 - `publicApi`: public calls
 - `protectedApi`: bearer token calls with 401 refresh queue + retry
 - refresh uses HttpOnly cookie strategy (`withCredentials: true`)
@@ -78,6 +71,7 @@ node ../dist/cli.js add feature orders
 ```
 
 `add feature` now always creates:
+
 - `src/features/<feature>/api/use-<feature>.ts`
 - `src/features/<feature>/components/`
 - `src/features/<feature>/services.ts`
@@ -95,10 +89,12 @@ node ../dist/cli.js add module
 Module copy is non-destructive: existing files are kept and reported as skipped conflicts.
 
 Interactive multiselect shows available module catalog:
+
 - `chat`
 - `supabase`
 - `supabase-realtime`
 - `seo`
+- `resend`
 
 Non-interactive example:
 
@@ -115,6 +111,7 @@ node ../dist/cli.js add auth-provider
 ```
 
 Supported providers:
+
 - `google`
 - `facebook`
 
@@ -125,6 +122,7 @@ node ../dist/cli.js add auth-provider --provider google --provider facebook --ye
 ```
 
 This command:
+
 - updates `src/lib/auth.ts` provider block
 - merges provider env keys into `.env` and `.env.example`
 - runs Better Auth schema generation helper (with install prompt if CLI is missing in interactive mode)
@@ -138,6 +136,7 @@ node ../dist/cli.js migrate
 ```
 
 Optional flags:
+
 - `--name <migration-name>`: set migration name manually
 - `--skip-generate`: pass through to `prisma migrate dev --skip-generate`
 
@@ -161,7 +160,7 @@ node ../dist/cli.js migrate --name init_auth --skip-generate
 - i18n base with `next-intl`
 - Sonner notifications
 - date-fns utility library
-- Optional modules: chat, supabase, supabase-realtime, seo
+- Optional modules: chat, supabase, supabase-realtime, seo, resend
 
 ## Template structure
 
@@ -175,11 +174,12 @@ Optional module templates:
 - `templates/features/supabase`
 - `templates/features/supabase-realtime`
 - `templates/features/seo`
+- `templates/features/resend`
 
 ## Realtime chat schema foundation
 
 Chatbox Prisma entities are appended only when you add the `chat` module
-(`create --module chat` or `add module --module chat`).
+(during `create` or via `add module --module chat`).
 
 When chat is selected, NexTCLI auto-adds `supabase-realtime` if missing.
 

package/dist/cli.js

@@ -169,7 +169,8 @@ var templatePaths = {
   chat: path2.join(rootDir, "templates/features/chat"),
   supabase: path2.join(rootDir, "templates/features/supabase"),
   supabaseRealtime: path2.join(rootDir, "templates/features/supabase-realtime"),
-  seo: path2.join(rootDir, "templates/features/seo")
+  seo: path2.join(rootDir, "templates/features/seo"),
+  resend: path2.join(rootDir, "templates/features/resend")
 };
 
 // src/core/modules.ts
@@ -216,6 +217,21 @@ var optionalModules = [
     description: "Adds robots/sitemap and JsonLd helper files",
     templatePath: templatePaths.seo,
     env: {}
+  },
+  {
+    id: "resend",
+    label: "Resend email",
+    description: "Adds Resend client, send helper, and React Email welcome template",
+    templatePath: templatePaths.resend,
+    env: {
+      RESEND_API_KEY: "",
+      RESEND_FROM_EMAIL: ""
+    },
+    dependencies: {
+      resend: "^6.9.2",
+      "@react-email/components": "^1.0.12",
+      "react-email": "^4.0.0"
+    }
   }
 ];
 function getModuleById(moduleId) {
@@ -234,23 +250,24 @@ import {
   isCancel,
   multiselect,
   outro,
-  select
+  select,
+  text
 } from "@clack/prompts";
 
 // src/core/theme.ts
 var reset = "\x1B[0m";
-function paint(code, text) {
-  return `${code}${text}${reset}`;
+function paint(code, text2) {
+  return `${code}${text2}${reset}`;
 }
 var theme = {
-  cyan: (text) => paint("\x1B[36m", text),
-  green: (text) => paint("\x1B[32m", text),
-  yellow: (text) => paint("\x1B[33m", text),
-  red: (text) => paint("\x1B[31m", text),
-  blue: (text) => paint("\x1B[34m", text),
-  magenta: (text) => paint("\x1B[35m", text),
-  dim: (text) => paint("\x1B[2m", text),
-  bold: (text) => paint("\x1B[1m", text)
+  cyan: (text2) => paint("\x1B[36m", text2),
+  green: (text2) => paint("\x1B[32m", text2),
+  yellow: (text2) => paint("\x1B[33m", text2),
+  red: (text2) => paint("\x1B[31m", text2),
+  blue: (text2) => paint("\x1B[34m", text2),
+  magenta: (text2) => paint("\x1B[35m", text2),
+  dim: (text2) => paint("\x1B[2m", text2),
+  bold: (text2) => paint("\x1B[1m", text2)
 };
 var bannerGradient = [
   "\x1B[38;5;51m",
@@ -324,6 +341,16 @@ async function askConfirm(message, initialValue = false) {
   handleCancelled(value);
   return Boolean(value);
 }
+async function askText(message, options = {}) {
+  const value = await text({
+    message,
+    placeholder: options.placeholder,
+    initialValue: options.initialValue,
+    validate: options.validate
+  });
+  handleCancelled(value);
+  return value;
+}
 
 // src/core/auth-bootstrap.ts
 import { spawn } from "child_process";
@@ -1075,24 +1102,14 @@ async function runInstall(packageManager, cwd) {
         resolve();
         return;
       }
-      reject(new Error(`Dependency installation failed with code ${code ?? "unknown"}`));
+      reject(
+        new Error(
+          `Dependency installation failed with code ${code ?? "unknown"}`
+        )
+      );
     });
   });
 }
-function parseModuleIds(moduleValues) {
-  if (!moduleValues || moduleValues.length === 0) {
-    return [];
-  }
-  const flattened = moduleValues.flatMap((value) => value.split(","));
-  const normalized = flattened.map((value) => value.trim()).filter(Boolean);
-  const validIds = new Set(optionalModules.map((module) => module.id));
-  for (const moduleId of normalized) {
-    if (!validIds.has(moduleId)) {
-      throw new Error(`Unknown module: ${moduleId}`);
-    }
-  }
-  return [...new Set(normalized)];
-}
 function toProjectSlug(input) {
   return input.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
 }
@@ -1108,39 +1125,49 @@ function normalizeModuleSelection2(moduleIds) {
     autoAddedModules: autoAdded
   };
 }
+async function resolveProjectName() {
+  while (true) {
+    const projectName = await askText("What is your project name?", {
+      placeholder: "my-nextjs-app",
+      validate: (value) => {
+        if (!value.trim()) {
+          return "Project name is required.";
+        }
+        if (!toProjectSlug(value)) {
+          return "Use letters, numbers, dots, underscores, or dashes.";
+        }
+      }
+    });
+    const targetPath = path5.resolve(process.cwd(), projectName);
+    if (await pathExists(targetPath)) {
+      log.error(`Target directory already exists: ${targetPath}`);
+      continue;
+    }
+    return projectName;
+  }
+}
 function registerCreateCommand(program2) {
-  program2.command("create").description("Create a new outsource-ready Next.js app").argument("<project-name>", "Target project name").option("--package-manager <manager>", "Package manager: npm|pnpm|yarn|bun").option("--module <module...>", "Preselect modules (chat,supabase,supabase-realtime,seo)").option("--install", "Install dependencies after generation").option("--no-install", "Skip dependency installation").option("--yes", "Skip prompts and use defaults").action(async (projectName, options) => {
+  program2.command("create").description("Create a new outsource-ready Next.js app").action(async () => {
     startPrompt("NexTCLI project creation");
-    const packageManager = options.packageManager ?? (options.yes ? "npm" : await askSelect(
+    const projectName = await resolveProjectName();
+    const targetPath = path5.resolve(process.cwd(), projectName);
+    const projectDirectoryName = path5.basename(targetPath);
+    const projectSlug = toProjectSlug(projectDirectoryName);
+    const packageManager = await askSelect(
       "Which package manager do you want to use?",
       [
         { value: "npm", label: "npm", hint: "Default and stable" },
         { value: "pnpm", label: "pnpm", hint: "Fast and disk-efficient" },
         { value: "yarn", label: "yarn", hint: "Classic workspace choice" },
-        { value: "bun", label: "bun", hint: "Fast runtime and package manager" }
+        {
+          value: "bun",
+          label: "bun",
+          hint: "Fast runtime and package manager"
+        }
       ],
       "npm"
-    ));
-    const allowedManagers = /* @__PURE__ */ new Set(["npm", "pnpm", "yarn", "bun"]);
-    if (!allowedManagers.has(packageManager)) {
-      log.error("Invalid --package-manager value. Use npm, pnpm, yarn, or bun.");
-      process.exitCode = 1;
-      return;
-    }
-    const targetPath = path5.resolve(process.cwd(), projectName);
-    if (await pathExists(targetPath)) {
-      log.error(`Target directory already exists: ${targetPath}`);
-      process.exitCode = 1;
-      return;
-    }
-    const projectDirectoryName = path5.basename(targetPath);
-    const projectSlug = toProjectSlug(projectDirectoryName);
-    if (!projectSlug) {
-      log.error("Invalid project name. Use letters, numbers, dots, underscores, or dashes.");
-      process.exitCode = 1;
-      return;
-    }
-    const rawModules = options.module && options.module.length > 0 ? parseModuleIds(options.module) : options.yes ? [] : await askMultiSelect(
+    );
+    const rawModules = await askMultiSelect(
       "Select optional modules to include:",
       optionalModules.map((module) => ({
         value: module.id,
@@ -1150,8 +1177,7 @@ function registerCreateCommand(program2) {
       []
     );
     const { selectedModules, autoAddedModules } = normalizeModuleSelection2(rawModules);
-    const installFlagProvided = process.argv.includes("--install") || process.argv.includes("--no-install");
-    const shouldInstall = installFlagProvided ? Boolean(options.install) : options.yes ? false : await askConfirm("Install dependencies now?", true);
+    const shouldInstall = await askConfirm("Install dependencies now?", true);
     await copyDirectory(templatePaths.base, targetPath);
     for (const moduleId of selectedModules) {
       const moduleDefinition = getModuleById(moduleId);
@@ -1161,19 +1187,18 @@ function registerCreateCommand(program2) {
     if (selectedModules.includes("chat")) {
       chatSchemaStatus = await ensureChatSchemaInProject(targetPath);
     }
-    const moduleEnvEntries = selectedModules.reduce((acc, moduleId) => {
-      const module = getModuleById(moduleId);
-      return {
-        ...acc,
-        ...module.env
-      };
-    }, {});
+    const moduleEnvEntries = selectedModules.reduce(
+      (acc, moduleId) => {
+        const module = getModuleById(moduleId);
+        return {
+          ...acc,
+          ...module.env
+        };
+      },
+      {}
+    );
     if (Object.keys(moduleEnvEntries).length > 0) {
-      const envTargets = [
-        ".env",
-        ".env.example",
-        ".env.development"
-      ];
+      const envTargets = [".env", ".env.example", ".env.development"];
       for (const envFile of envTargets) {
         const envPath = path5.join(targetPath, envFile);
         if (await pathExists(envPath)) {
@@ -1181,21 +1206,27 @@ function registerCreateCommand(program2) {
         }
       }
     }
-    const dependencyEntries = selectedModules.reduce((acc, moduleId) => {
-      const module = getModuleById(moduleId);
-      return {
-        ...acc,
-        ...module.dependencies ?? {}
-      };
-    }, {});
+    const dependencyEntries = selectedModules.reduce(
+      (acc, moduleId) => {
+        const module = getModuleById(moduleId);
+        return {
+          ...acc,
+          ...module.dependencies ?? {}
+        };
+      },
+      {}
+    );
     if (Object.keys(dependencyEntries).length > 0) {
-      await addDependencies(path5.join(targetPath, "package.json"), dependencyEntries);
+      await addDependencies(
+        path5.join(targetPath, "package.json"),
+        dependencyEntries
+      );
     }
     const betterAuthSecret = randomBytes(32).toString("base64url");
     await replaceTokensInDirectory(targetPath, {
-      "__PROJECT_NAME__": projectSlug,
-      "__ENABLE_CHAT__": selectedModules.includes("chat") ? "true" : "false",
-      "__BETTER_AUTH_SECRET__": betterAuthSecret
+      __PROJECT_NAME__: projectSlug,
+      __ENABLE_CHAT__: selectedModules.includes("chat") ? "true" : "false",
+      __BETTER_AUTH_SECRET__: betterAuthSecret
     });
     if (shouldInstall) {
       log.step(`Installing dependencies with ${packageManager}...`);
@@ -1214,7 +1245,9 @@ function registerCreateCommand(program2) {
       log.detail("Auto-added", autoAddedModules.join(", "));
     }
     if (chatSchemaStatus === "added") {
-      log.info("Optional chat schema block was appended to prisma/schema.prisma.");
+      log.info(
+        "Optional chat schema block was appended to prisma/schema.prisma."
+      );
     }
     log.step(`Next: cd ${projectName} && ${packageManager} run dev`);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinhnguyencth1204/nextcli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI scaffolder for outsourced Next.js projects",
   "type": "module",
   "bin": {

package/templates/features/resend/src/emails/welcome-email.tsx

@@ -0,0 +1,28 @@
+import {
+  Body,
+  Container,
+  Head,
+  Heading,
+  Html,
+  Preview,
+  Text,
+} from "@react-email/components";
+
+export type WelcomeEmailProps = {
+  name: string;
+};
+
+export function WelcomeEmail({ name }: WelcomeEmailProps) {
+  return (
+    <Html>
+      <Head />
+      <Preview>Welcome aboard</Preview>
+      <Body style={{ fontFamily: "sans-serif", backgroundColor: "#f6f6f6" }}>
+        <Container style={{ padding: "24px", backgroundColor: "#ffffff" }}>
+          <Heading>Welcome, {name}</Heading>
+          <Text>Thanks for joining. We are glad to have you on board.</Text>
+        </Container>
+      </Body>
+    </Html>
+  );
+}

package/templates/features/resend/src/lib/resend/client.ts

@@ -0,0 +1,5 @@
+import { Resend } from "resend";
+
+const apiKey = process.env.RESEND_API_KEY?.trim();
+
+export const resend = apiKey ? new Resend(apiKey) : null;

package/templates/features/resend/src/lib/resend/config.ts

@@ -0,0 +1,8 @@
+export function getResendFromAddress(): string | null {
+  const from = process.env.RESEND_FROM_EMAIL?.trim();
+  return from || null;
+}
+
+export function isResendConfigured(): boolean {
+  return Boolean(process.env.RESEND_API_KEY?.trim() && getResendFromAddress());
+}

package/templates/features/resend/src/lib/resend/send-email.ts

@@ -0,0 +1,146 @@
+import type { ReactNode } from "react";
+import type { CreateEmailOptions } from "resend";
+
+import { resend } from "@/lib/resend/client";
+import { getResendFromAddress } from "@/lib/resend/config";
+
+export type ResendError = {
+  message: string;
+  name: string;
+};
+
+export type SendEmailResult = {
+  data: { id: string } | null;
+  error: ResendError | null;
+};
+
+export type SendEmailInput = {
+  to: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  /** Pass as a function call: WelcomeEmail({ name }), not JSX. */
+  react?: ReactNode;
+  cc?: string | string[];
+  bcc?: string | string[];
+  replyTo?: string | string[];
+  scheduledAt?: string;
+  headers?: Record<string, string>;
+  tags?: Array<{ name: string; value: string }>;
+  attachments?: CreateEmailOptions["attachments"];
+  template?: {
+    id: string;
+    variables?: Record<string, string | number>;
+  };
+  idempotencyKey?: string;
+};
+
+function notConfigured(message: string): SendEmailResult {
+  return {
+    data: null,
+    error: { message, name: "NOT_CONFIGURED" },
+  };
+}
+
+function validationError(message: string): SendEmailResult {
+  return {
+    data: null,
+    error: { message, name: "VALIDATION_ERROR" },
+  };
+}
+
+function countContentFields(input: SendEmailInput): number {
+  let count = 0;
+  if (input.html) count += 1;
+  if (input.text) count += 1;
+  if (input.react) count += 1;
+  if (input.template) count += 1;
+  return count;
+}
+
+export async function sendEmail(
+  input: SendEmailInput,
+): Promise<SendEmailResult> {
+  if (!resend) {
+    return notConfigured(
+      "Resend is not configured. Set RESEND_API_KEY in your environment.",
+    );
+  }
+
+  const from = getResendFromAddress();
+  if (!from) {
+    return notConfigured(
+      "Resend from address is not configured. Set RESEND_FROM_EMAIL to a verified domain sender.",
+    );
+  }
+
+  const contentCount = countContentFields(input);
+  if (contentCount === 0) {
+    return validationError(
+      "Provide one of html, text, react, or template for the email body.",
+    );
+  }
+
+  if (contentCount > 1) {
+    return validationError(
+      "Provide only one body source: html, text, react, or template.",
+    );
+  }
+
+  const { idempotencyKey, template, ...rest } = input;
+
+  const payload: CreateEmailOptions = template
+    ? {
+        from,
+        to: rest.to,
+        subject: rest.subject,
+        template,
+        cc: rest.cc,
+        bcc: rest.bcc,
+        replyTo: rest.replyTo,
+        scheduledAt: rest.scheduledAt,
+        headers: rest.headers,
+        tags: rest.tags,
+        attachments: rest.attachments,
+      }
+    : {
+        from,
+        to: rest.to,
+        subject: rest.subject,
+        html: rest.html,
+        text: rest.text,
+        react: rest.react,
+        cc: rest.cc,
+        bcc: rest.bcc,
+        replyTo: rest.replyTo,
+        scheduledAt: rest.scheduledAt,
+        headers: rest.headers,
+        tags: rest.tags,
+        attachments: rest.attachments,
+      };
+
+  const result = await resend.emails.send(
+    payload,
+    idempotencyKey ? { idempotencyKey } : undefined,
+  );
+
+  return {
+    data: result.data,
+    error: result.error,
+  };
+}
+
+export async function sendWelcomeEmail(input: {
+  to: string;
+  name: string;
+  idempotencyKey?: string;
+}): Promise<SendEmailResult> {
+  const { WelcomeEmail } = await import("@/emails/welcome-email");
+
+  return sendEmail({
+    to: input.to,
+    subject: "Welcome",
+    react: WelcomeEmail({ name: input.name }),
+    idempotencyKey: input.idempotencyKey ?? `welcome-user/${input.to}`,
+  });
+}