@shipindays/shipindays 0.1.12

package/index.js

@@ -0,0 +1,406 @@
+#!/usr/bin/env node
+
+import * as p from "@clack/prompts";
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const TEMPLATES_DIR = path.join(__dirname, "templates");
+const BASE_DIR = path.join(TEMPLATES_DIR, "base");
+const BLOCKS_DIR = path.join(TEMPLATES_DIR, "blocks");
+
+function printBanner() {
+  console.log("\n");
+  console.log(chalk.green("  ⚡ shipindays"));
+  console.log(chalk.dim("  Ship your SaaS in days, not months."));
+  console.log(chalk.dim("  https://shipindays.nikhilsai.in\n"));
+}
+
+const AUTH_PROVIDERS = {
+  supabase: {
+    label: "Supabase Auth",
+    hint: "Magic link + OAuth — server.ts + client.ts included",
+  },
+  nextauth: {
+    label: "NextAuth v5",
+    hint: "Credentials + Google + GitHub — self-hostable",
+  },
+};
+
+const EMAIL_PROVIDERS = {
+  resend: {
+    label: "Resend",
+    hint: "resend.com — best DX, generous free tier",
+  },
+  nodemailer: {
+    label: "Nodemailer",
+    hint: "SMTP — works with Gmail, Outlook, any mail server",
+  },
+};
+
+const ENV_VARS = {
+  base: {
+    "# App": [
+      "NEXT_PUBLIC_APP_URL=http://localhost:3000",
+    ],
+  },
+  auth: {
+    supabase: {
+      "# Supabase (supabase.com → project → settings → API)": [
+        "NEXT_PUBLIC_SUPABASE_URL=",
+        "NEXT_PUBLIC_SUPABASE_ANON_KEY=",
+        "SUPABASE_SERVICE_ROLE_KEY=",
+      ],
+    },
+    nextauth: {
+      "# NextAuth": [
+        "AUTH_SECRET=",
+        "NEXTAUTH_URL=http://localhost:3000",
+      ],
+      "# OAuth — Google (console.cloud.google.com)": [
+        "AUTH_GOOGLE_ID=",
+        "AUTH_GOOGLE_SECRET=",
+      ],
+      "# OAuth — GitHub (github.com → Settings → Developer settings → OAuth Apps)": [
+        "AUTH_GITHUB_ID=",
+        "AUTH_GITHUB_SECRET=",
+      ],
+    },
+  },
+  email: {
+    resend: {
+      "# Resend (resend.com → API Keys)": [
+        "RESEND_API_KEY=",
+      ],
+    },
+    nodemailer: {
+      "# SMTP / Nodemailer": [
+        "SMTP_HOST=smtp.gmail.com",
+        "SMTP_PORT=587",
+        "SMTP_SECURE=false",
+        "SMTP_USER=",
+        "SMTP_PASS=",
+        "SMTP_FROM=you@yourdomain.com",
+      ],
+    },
+  },
+};
+
+// Recursively copy a directory, skipping unwanted folders.
+// We do this manually instead of fs.copy(filter) because fs-extra's filter
+// callback skips the root directory itself on some platforms when the
+// target doesn't exist yet, resulting in nothing being copied.
+async function copyDir(src, dest, skipNames = []) {
+  await fs.ensureDir(dest);
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (skipNames.includes(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath, skipNames);
+    } else {
+      await fs.copy(srcPath, destPath, { overwrite: true });
+    }
+  }
+}
+
+// Each block lives at templates/blocks/<feature>/<provider>/
+// Its src/ folder is copied on top of the project's src/.
+// To add a new provider: create the folder, match exported function names,
+// add a package.json with extra deps, register it in the provider map above,
+// and add env vars below.
+async function injectBlock(feature, provider, targetPath) {
+  const blockRoot = path.join(BLOCKS_DIR, feature, provider);
+  const blockSrcDir = path.join(blockRoot, "src");
+
+  if (!await fs.pathExists(blockRoot)) {
+    throw new Error(
+      `Block not found: ${blockRoot}\n` +
+      `Make sure templates/blocks/${feature}/${provider}/ exists.`
+    );
+  }
+
+  if (!await fs.pathExists(blockSrcDir)) {
+    throw new Error(
+      `Block src/ folder missing: ${blockSrcDir}\n` +
+      `Structure: templates/blocks/${feature}/${provider}/src/...`
+    );
+  }
+
+  await copyDir(blockSrcDir, path.join(targetPath, "src"), ["node_modules", ".next"]);
+}
+
+// Reads the block's package.json and merges its deps into the project's package.json.
+// The block's package.json is never copied as a file — only read for merging.
+async function mergePackageJson(targetPath, feature, provider) {
+  const blockPkgPath = path.join(BLOCKS_DIR, feature, provider, "package.json");
+  const targetPkgPath = path.join(targetPath, "package.json");
+
+  if (!await fs.pathExists(blockPkgPath)) return;
+  if (!await fs.pathExists(targetPkgPath)) return;
+
+  const targetPkg = await fs.readJson(targetPkgPath);
+  const blockPkg = await fs.readJson(blockPkgPath);
+
+  targetPkg.dependencies = {
+    ...(targetPkg.dependencies ?? {}),
+    ...(blockPkg.dependencies ?? {}),
+  };
+  targetPkg.devDependencies = {
+    ...(targetPkg.devDependencies ?? {}),
+    ...(blockPkg.devDependencies ?? {}),
+  };
+
+  await fs.writeJson(targetPkgPath, targetPkg, { spaces: 2 });
+}
+
+function buildEnvExample(choices) {
+  let out = [
+    "# shipindays — environment variables",
+    "# 1. cp .env.example .env.local",
+    "# 2. Fill in every blank value before running npm run dev",
+    "",
+  ].join("\n");
+
+  for (const [comment, vars] of Object.entries(ENV_VARS.base)) {
+    out += `${comment}\n${vars.join("\n")}\n\n`;
+  }
+
+  for (const [feature, provider] of Object.entries(choices)) {
+    const providerVars = ENV_VARS[feature]?.[provider];
+    if (!providerVars) continue;
+    for (const [comment, vars] of Object.entries(providerVars)) {
+      out += `${comment}\n${vars.join("\n")}\n\n`;
+    }
+  }
+
+  return out.trimEnd() + "\n";
+}
+
+function buildGitignore() {
+  return [
+    "# dependencies",
+    "node_modules/",
+    ".pnp",
+    ".pnp.js",
+    "",
+    "# Next.js",
+    ".next/",
+    "out/",
+    "build/",
+    "",
+    "# env — never commit these",
+    ".env",
+    ".env.local",
+    ".env.*.local",
+    "",
+    "# misc",
+    ".DS_Store",
+    "*.pem",
+    "npm-debug.log*",
+    "yarn-debug.log*",
+    "yarn-error.log*",
+    "",
+    "# drizzle",
+    "drizzle/",
+    "",
+    "# Vercel",
+    ".vercel",
+  ].join("\n");
+}
+
+function isValidName(n) { return /^[a-zA-Z0-9-_]+$/.test(n); }
+
+function toSlug(s) {
+  return s.trim().toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-_]/g, "");
+}
+
+function detectPM() {
+  const a = process.env.npm_config_user_agent ?? "";
+  return a.includes("pnpm") ? "pnpm" : a.includes("yarn") ? "yarn" : "npm";
+}
+
+function run(cmd, cwd) { execSync(cmd, { cwd, stdio: "inherit" }); }
+
+function printNextSteps(projectDir, pm, choices) {
+  const isHere = projectDir === "." || projectDir === "./";
+  const runCmd = pm === "npm" ? "npm run" : pm;
+  let n = 1;
+  const s = (cmd) => console.log(chalk.dim(`  ${n++}. ${cmd}`));
+
+  console.log("\n");
+  console.log(chalk.green("  ✓ Your SaaS is scaffolded.\n"));
+  console.log(chalk.dim(`  Auth  → ${choices.auth}`));
+  console.log(chalk.dim(`  Email → ${choices.email}`));
+  console.log("");
+  if (!isHere) s(`cd ${projectDir.replace(/^\.\//, "")}`);
+  s("cp .env.example .env.local");
+  s("  → Fill in your keys (see comments in .env.local)");
+  s(`${runCmd} db:push`);
+  s(`${runCmd} dev`);
+  console.log("");
+  console.log(chalk.dim("  Please give a star to the repo! Thanks"));
+  console.log(chalk.dim("  GitHub  → https://github.com/nikhilsaiankilla/shipindays"));
+  console.log(chalk.dim("  Twitter → https://x.com/itzznikhilsai"));
+  console.log("");
+  console.log(chalk.green("  Now go build what only you can build.\n"));
+}
+
+async function main() {
+  printBanner();
+  p.intro(chalk.bgGreen(chalk.black(" shipindays ")));
+
+  // 1. Project directory
+  let projectDir = process.argv[2];
+
+  if (!projectDir) {
+    const answer = await p.text({
+      message: "Where should we create your project?",
+      placeholder: "./my-saas",
+      defaultValue: "./my-saas",
+      validate(val) {
+        const clean = val.replace(/^\.\//, "");
+        if (clean !== "." && !isValidName(clean)) {
+          return "Letters, numbers, hyphens, underscores only.";
+        }
+      },
+    });
+    if (p.isCancel(answer)) { p.cancel("Cancelled."); process.exit(0); }
+    projectDir = answer;
+  }
+
+  const isCurrentDir = projectDir === "." || projectDir === "./";
+  const targetPath = isCurrentDir
+    ? process.cwd()
+    : path.resolve(process.cwd(), projectDir.replace(/^\.\//, ""));
+  const projectName = isCurrentDir
+    ? path.basename(process.cwd())
+    : toSlug(path.basename(projectDir.replace(/^\.\//, "")));
+
+  if (!isCurrentDir && await fs.pathExists(targetPath)) {
+    const files = (await fs.readdir(targetPath)).filter(f => f !== ".git");
+    if (files.length > 0) {
+      const ok = await p.confirm({
+        message: `${projectDir} is not empty. Overwrite?`,
+        initialValue: false,
+      });
+      if (p.isCancel(ok) || !ok) { p.cancel("Cancelled."); process.exit(0); }
+    }
+  }
+
+  // 2. Pick auth provider
+  const authProvider = await p.select({
+    message: "Auth provider",
+    options: Object.entries(AUTH_PROVIDERS).map(([value, { label, hint }]) => ({
+      value, label, hint,
+    })),
+  });
+  if (p.isCancel(authProvider)) { p.cancel("Cancelled."); process.exit(0); }
+
+  // 3. Pick email provider
+  const emailProvider = await p.select({
+    message: "Email provider",
+    options: Object.entries(EMAIL_PROVIDERS).map(([value, { label, hint }]) => ({
+      value, label, hint,
+    })),
+  });
+  if (p.isCancel(emailProvider)) { p.cancel("Cancelled."); process.exit(0); }
+
+  const choices = { auth: authProvider, email: emailProvider };
+
+  // 4. Git + install preferences
+  const initGit = await p.confirm({
+    message: "Initialize a git repository?",
+    initialValue: true,
+  });
+  if (p.isCancel(initGit)) { p.cancel("Cancelled."); process.exit(0); }
+
+  const pm = detectPM();
+  const install = await p.confirm({
+    message: `Install dependencies with ${pm}?`,
+    initialValue: true,
+  });
+  if (p.isCancel(install)) { p.cancel("Cancelled."); process.exit(0); }
+
+  const spin = p.spinner();
+
+  // 5. Copy base template
+  spin.start("Copying base template...");
+  if (!await fs.pathExists(BASE_DIR)) {
+    spin.stop(chalk.red(`Base template not found: ${BASE_DIR}`));
+    process.exit(1);
+  }
+  await copyDir(BASE_DIR, targetPath, ["node_modules", ".next", ".turbo"]);
+  spin.stop("Base template copied.");
+
+  // 6. Inject auth block
+  spin.start(`Injecting auth: ${choices.auth}...`);
+  await injectBlock("auth", choices.auth, targetPath);
+  await mergePackageJson(targetPath, "auth", choices.auth);
+  spin.stop(`Auth: ${choices.auth} ✓`);
+
+  // 7. Inject email block
+  spin.start(`Injecting email: ${choices.email}...`);
+  await injectBlock("email", choices.email, targetPath);
+  await mergePackageJson(targetPath, "email", choices.email);
+  spin.stop(`Email: ${choices.email} ✓`);
+
+  // 8. Write .env.example
+  spin.start("Writing .env.example...");
+  await fs.outputFile(path.join(targetPath, ".env.example"), buildEnvExample(choices));
+  spin.stop(".env.example written.");
+
+  // 9. Write .gitignore
+  await fs.outputFile(path.join(targetPath, ".gitignore"), buildGitignore());
+
+  // 10. Set project name in package.json
+  spin.start("Configuring package.json...");
+  const pkgPath = path.join(targetPath, "package.json");
+  if (await fs.pathExists(pkgPath)) {
+    const pkg = await fs.readJson(pkgPath);
+    pkg.name = projectName;
+    await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+  }
+  spin.stop("package.json configured.");
+
+  // 11. Git init
+  if (initGit) {
+    spin.start("Initialising git...");
+    try {
+      run("git init", targetPath);
+      run("git add -A", targetPath);
+      run(`git commit -m "chore: scaffold from shipindays"`, targetPath);
+      spin.stop("Git initialised.");
+    } catch {
+      spin.stop(chalk.yellow("Git skipped — run manually."));
+    }
+  }
+
+  // 12. Install dependencies
+  if (install) {
+    spin.start(`Installing with ${pm}...`);
+    try {
+      const cmd =
+        pm === "yarn" ? "yarn" :
+          pm === "pnpm" ? "pnpm install" :
+            "npm install";
+      run(cmd, targetPath);
+      spin.stop("Dependencies installed.");
+    } catch {
+      spin.stop(chalk.yellow(`Run '${pm} install' manually.`));
+    }
+  }
+
+  p.outro(chalk.green("Done!"));
+  printNextSteps(projectDir, pm, choices);
+}
+
+main().catch((err) => {
+  console.error(chalk.red("\n  Fatal: " + err.message));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@shipindays/shipindays",
+  "version": "0.1.12",
+  "description": "Open source CLI to scaffold a Next.js SaaS. Pick your auth, email, and payments wired up and ready to ship.",
+  "type": "module",
+  "bin": {
+    "create-shipindays-app": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "templates"
+  ],
+  "keywords": [
+    "nextjs",
+    "saas",
+    "starter",
+    "boilerplate",
+    "supabase",
+    "drizzle",
+    "stripe",
+    "resend"
+  ],
+  "author": "Nikhil Sai <nikhilsaiankilla@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://shipindays.nikhilsai.in",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nikhilsaiankilla/shipindays"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/base/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/templates/base/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/dev/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/templates/base/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;