create-nextjs-stack 0.1.9 → 0.2.0

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/create-nextjs-stack.svg?style=flat-square)](https://www.npmjs.com/package/create-nextjs-stack)
 [![npm downloads](https://img.shields.io/npm/dm/create-nextjs-stack.svg?style=flat-square)](https://www.npmjs.com/package/create-nextjs-stack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square)](https://nodejs.org/)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen?style=flat-square)](https://nodejs.org/)
 
 **A zero-config CLI to scaffold production-ready Next.js applications.**  
 Choose between a marketing landing page, a Supabase admin panel, or both — in one command.
@@ -336,11 +336,6 @@ NEXT_PUBLIC_SUPABASE_URL=https://xxxxxxxxxxxx.supabase.co
 NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsIn...
 SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsIn...     # Never expose this client-side!
 
-# Supabase project meta (used by Supabase CLI / migrations)
-SUPABASE_PROJECT_ID=xxxxxxxxxxxx
-SUPABASE_PROJECT_NAME=my-project
-SUPABASE_DATABASE_PASSWORD=your-db-password
-
 # Used to verify on-demand revalidation requests
 REVALIDATION_SECRET=a-random-secret-string
 
@@ -349,7 +344,6 @@ REVALIDATION_SECRET=a-random-secret-string
 NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your-cloud-name
 CLOUDINARY_API_KEY=000000000000000
 CLOUDINARY_API_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxx
-CLOUDINARY_ID=your-cloud-name                   # Same as CLOUD_NAME, for SDK compat
 CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME
 
 # ─── Site ──────────────────────────────────────────────────────────────────────
@@ -382,7 +376,7 @@ CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME
 
 | Tool    | Minimum Version |
 | ------- | --------------- |
-| Node.js | 18.x            |
+| Node.js | 20.x            |
 | npm     | 9.x             |
 
 ### Available Scripts
@@ -497,7 +491,7 @@ A: Yes — create two separate Vercel projects pointing to the same repository,
 
 ## 🤝 Contributing
 
-Contributions, bug reports, and feature requests are welcome!
+Contributions, bug reports, and feature requests are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
 
 1. [Open an issue](https://github.com/mburakaltiparmak/create-nextjs-stack/issues) to discuss what you'd like to change.
 2. Fork the repository and create a feature branch:

package/bin/cli.js

@@ -6,10 +6,39 @@ const { program } = require("commander");
 const prompts = require("prompts");
 const chalk = require("chalk");
 const ora = require("ora");
+const { execSync } = require("child_process");
+
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("bun")) return "bun";
+  return "npm";
+}
+
+function isPackageManagerAvailable(pm) {
+  try {
+    execSync(`${pm} --version`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // Read version from package.json
 const packageJson = require("../package.json");
 
+process.on("SIGINT", () => {
+  console.log(chalk.red("\n\nOperation cancelled."));
+  process.exit(1);
+});
+const updateNotifier = require("update-notifier");
+
+const notifier = updateNotifier({ pkg: packageJson, updateCheckInterval: 1000 * 60 * 60 * 24 });
+if (notifier.update) {
+  notifier.notify();
+}
+
 program
   .name("create-nextjs-stack")
   .version(packageJson.version, "-v, --version", "Output the current version")
@@ -17,6 +46,17 @@ program
   .argument("[project-directory]", "Directory to create the project in")
   .option("-t, --template <type>", "Template type: web, admin, or full-stack")
   .action(async (projectDirectory, options) => {
+    const validTemplates = ["web", "admin", "full-stack"];
+    if (options.template && !validTemplates.includes(options.template)) {
+      console.log(
+        chalk.red(
+          `\nInvalid template: "${options.template}"\n` +
+            `Valid options: ${validTemplates.join(", ")}\n`
+        )
+      );
+      process.exit(1);
+    }
+
     let targetDir = projectDirectory;
 
     // 1. Get Project Name / Directory
@@ -162,24 +202,122 @@ program
 
       spinner.succeed("Scaffolding complete!");
 
-      console.log(`\nSuccess! Created project at ${root}\n`);
+      // Skip install prompts if testing
+      if (process.env.NODE_ENV !== "test" && process.env.VITEST !== "true") {
+        const detectedPm = detectPackageManager();
 
-      if (templateType === "full-stack") {
+        const { packageManager } = await prompts({
+          type: "select",
+          name: "packageManager",
+          message: "Which package manager would you like to use?",
+          choices: [
+            { title: "npm", value: "npm" },
+            { title: "yarn", value: "yarn" },
+            { title: "pnpm", value: "pnpm" },
+            { title: "bun", value: "bun" },
+          ].filter((choice) => isPackageManagerAvailable(choice.value)),
+          initial: ["npm", "yarn", "pnpm", "bun"].indexOf(detectedPm) >= 0 ? ["npm", "yarn", "pnpm", "bun"].indexOf(detectedPm) : 0,
+        });
+
+        if (!packageManager) {
+          console.log(chalk.red("\nOperation cancelled."));
+          process.exit(1);
+        }
+
+        const { shouldInstall } = await prompts({
+          type: "confirm",
+          name: "shouldInstall",
+          message: `Install dependencies with ${packageManager}?`,
+          initial: true,
+        });
+
+        if (shouldInstall === undefined) {
+          console.log(chalk.red("\nOperation cancelled."));
+          process.exit(1);
+        }
+
+        if (shouldInstall) {
+          const installTargets =
+            templateType === "full-stack"
+              ? [path.join(root, "web"), path.join(root, "admin")]
+              : [root];
+
+          for (const target of installTargets) {
+            const dirName = path.basename(target);
+            const installSpinner = ora(
+              `Installing dependencies in ${dirName}...`,
+            ).start();
+
+            try {
+              const installCmd =
+                packageManager === "yarn" ? "yarn" : `${packageManager} install`;
+
+              execSync(installCmd, {
+                cwd: target,
+                stdio: "pipe",
+              });
+
+              installSpinner.succeed(`Dependencies installed in ${dirName}`);
+            } catch (error) {
+              installSpinner.fail(`Failed to install dependencies in ${dirName}`);
+              console.log(
+                chalk.yellow(
+                  `  You can install manually: cd ${dirName} && ${packageManager} install`,
+                ),
+              );
+            }
+          }
+        }
+        
+        console.log(`\n${chalk.green("Success!")} Created project at ${root}\n`);
         console.log("Next steps:");
         console.log(chalk.cyan(`  cd ${appName}`));
-        console.log("  Then go to either web or admin folder:");
-        console.log(chalk.cyan(`  cd web`));
-        console.log(chalk.cyan(`  npm install`));
-        console.log(chalk.cyan(`  npm run dev`));
+
+        if (templateType === "full-stack") {
+          console.log("  Then go to either web or admin folder:");
+          console.log(chalk.cyan(`  cd web`));
+          if (!shouldInstall) {
+            console.log(chalk.cyan(`  ${packageManager || "npm"} install`));
+          }
+          console.log(chalk.cyan(`  ${packageManager || "npm"} run dev`));
+        } else {
+          if (!shouldInstall) {
+            console.log(chalk.cyan(`  ${packageManager || "npm"} install`));
+          }
+          console.log(chalk.cyan(`  ${packageManager || "npm"} run dev`));
+        }
       } else {
+        // Fallback for tests
+        console.log(`\nSuccess! Created project at ${root}\n`);
         console.log("Next steps:");
         console.log(chalk.cyan(`  cd ${appName}`));
-        console.log(chalk.cyan(`  npm install`));
-        console.log(chalk.cyan(`  npm run dev`));
+        if (templateType === "full-stack") {
+          console.log("  Then go to either web or admin folder:");
+          console.log(chalk.cyan(`  cd web`));
+          console.log(chalk.cyan(`  npm install`));
+          console.log(chalk.cyan(`  npm run dev`));
+        } else {
+          console.log(chalk.cyan(`  npm install`));
+          console.log(chalk.cyan(`  npm run dev`));
+        }
       }
     } catch (error) {
       spinner.fail("Error scaffolding project.");
-      console.error(error);
+
+      if (error.code === "EACCES") {
+        console.error(
+          chalk.red("\nPermission denied. Try running with elevated privileges.")
+        );
+      } else if (error.code === "ENOSPC") {
+        console.error(chalk.red("\nNo disk space available."));
+      } else {
+        console.error(chalk.red(`\n${error.message || error}`));
+      }
+
+      if (process.env.DEBUG) {
+        console.error("\nFull error:", error);
+      }
+
       process.exit(1);
     }
   });

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "create-nextjs-stack",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "CLI to scaffold Next.js Landing Page and Supabase Admin Panel",
+  "type": "commonjs",
   "private": false,
   "bin": {
     "create-nextjs-stack": "./bin/cli.js"
@@ -10,26 +11,40 @@
     "bin",
     "templates"
   ],
+  "exports": {
+    ".": "./bin/cli.js"
+  },
   "scripts": {
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:verbose": "vitest run --reporter=verbose"
   },
   "dependencies": {
     "chalk": "^4.1.2",
     "commander": "^14.0.3",
     "fs-extra": "^11.3.3",
     "ora": "^5.4.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "update-notifier": "^5.1.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "keywords": [
     "nextjs",
+    "next",
     "starter",
     "template",
+    "scaffold",
+    "cli",
+    "create",
     "supabase",
     "admin",
-    "cli"
+    "tailwind",
+    "typescript",
+    "react",
+    "boilerplate"
   ],
   "author": "Mehmet Burak Altıparmak <mburakaltiparmak@gmail.com>",
   "license": "MIT",
@@ -44,6 +59,7 @@
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "execa": "^9.6.1",
     "vitest": "^4.0.18"
   }

package/templates/admin/package.json

@@ -2,6 +2,9 @@
   "name": "supabase-admin-template",
   "version": "0.1.0",
   "private": true,
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "scripts": {
     "dev": "next dev",
     "build": "next build",
@@ -16,12 +19,11 @@
     "clsx": "^2.1.1",
     "lucide-react": "^0.563.0",
     "next": "^16.1.6",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "react-hook-form": "^7.71.1",
     "react-redux": "^9.2.0",
     "react-toastify": "^11.0.3",
-    "redux-logger": "^3.0.6",
     "tailwind-merge": "^3.5.0"
   },
   "devDependencies": {
@@ -29,7 +31,6 @@
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@types/redux-logger": "^3.0.13",
     "babel-plugin-react-compiler": "1.0.0",
     "eslint": "^9",
     "eslint-config-next": "^16.1.6",

package/templates/admin/store/index.ts

@@ -1,13 +1,8 @@
 import { configureStore } from '@reduxjs/toolkit';
-import logger from 'redux-logger';
 import rootReducer from './reducers';
 
 const store = configureStore({
   reducer: rootReducer,
-  middleware: (getDefaultMiddleware) =>
-    process.env.NODE_ENV !== 'production'
-      ? getDefaultMiddleware().concat(logger)
-      : getDefaultMiddleware(),
 });
 
 // Inferred types — export and use via store/hooks.ts

package/templates/web/.env.example

@@ -1,25 +1,24 @@
-# Email Service (Resend)
-RESEND_API_KEY=your_resend_api_key_here
-RESEND_FROM_EMAIL=your_resend_from_email_here
-
-# Supabase Configuration
-SUPABASE_DATABASE_PASSWORD=your_supabase_database_password_here
-SUPABASE_PROJECT_NAME=your_supabase_project_name_here
-SUPABASE_PROJECT_ID=your_supabase_project_id_here
-NEXT_PUBLIC_SUPABASE_URL=your_supabase_url_here
-SUPABASE_PUBLISHABLE_KEY=your_supabase_publishable_key_here
-SUPABASE_SECRET_KEY=your_supabase_secret_key_here
+# ─── Supabase ──────────────────────────────────────────────────────────────────
+# https://supabase.com → Project Settings → API
+NEXT_PUBLIC_SUPABASE_URL=https://xxxxxxxxxxxx.supabase.co
 NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key_here
 SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key_here
-REVALIDATION_SECRET=your_revalidation_secret_here
 
-# Cloudinary Configuration
+# ─── Email (Resend) ───────────────────────────────────────────────────────────
+# https://resend.com → API Keys
+RESEND_API_KEY=your_resend_api_key_here
+RESEND_FROM_EMAIL=hello@yourdomain.com
+
+# ─── Cloudinary ────────────────────────────────────────────────────────────────
+# https://cloudinary.com → Dashboard
+NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloud_name_here
 CLOUDINARY_API_KEY=your_cloudinary_api_key_here
 CLOUDINARY_API_SECRET=your_cloudinary_api_secret_here
-CLOUDINARY_ID=your_cloud_name_here
-NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloud_name_here
 CLOUDINARY_URL=cloudinary://your_api_key:your_api_secret@your_cloud_name
 
-# Site Configuration
+# ─── Site ──────────────────────────────────────────────────────────────────────
 NEXT_PUBLIC_SITE_URL=http://localhost:3000
-NEXT_PUBLIC_GA_ID=your_google_analytics_id_here
+NEXT_PUBLIC_GA_ID=your_google_analytics_id_here
+
+# ─── Revalidation ─────────────────────────────────────────────────────────────
+REVALIDATION_SECRET=your_random_secret_string_here

package/templates/web/package.json

@@ -3,6 +3,9 @@
   "version": "0.1.0",
   "description": "Next.js Landing Page Starter",
   "private": true,
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "scripts": {
     "dev": "next dev --turbopack",
     "build": "next build --turbopack",
@@ -26,10 +29,9 @@
     "react-hook-form": "^7.70.0",
     "react-icons": "^5.5.0",
     "react-redux": "^9.2.0",
-    "redux-logger": "^3.0.6",
     "react-toastify": "^11.0.5",
     "resend": "^6.6.0",
-    "zod": "^4.3.5"
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3",
@@ -37,7 +39,6 @@
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@types/redux-logger": "^3.0.13",
     "eslint": "^9",
     "eslint-config-next": "^16.1.6",
     "tailwindcss": "^4",

package/templates/web/src/store/index.ts

@@ -1,13 +1,8 @@
 import { configureStore } from '@reduxjs/toolkit';
-import logger from 'redux-logger';
 import rootReducer from './reducers';
 
 const store = configureStore({
   reducer: rootReducer,
-  middleware: (getDefaultMiddleware) =>
-    process.env.NODE_ENV !== 'production'
-      ? getDefaultMiddleware().concat(logger)
-      : getDefaultMiddleware(),
 });
 
 // Inferred types — export and use via store/hooks.ts