boilerbase 1.0.1

package/README.md

@@ -0,0 +1,55 @@
+# BoilerBase
+
+A modern beginner-friendly backend scaffolding CLI for Node.js developers.
+
+## Install
+
+```bash
+npm install
+npm link
+```
+
+## Usage
+
+```bash
+npx boilerbase
+# or
+boilerbase
+```
+
+## What it does
+
+- Prompts for project settings in the terminal
+- Generates folders and starter files dynamically
+- Installs dependencies automatically
+- Opens the generated project in VS Code
+
+## Stack
+
+- Node.js
+- inquirer
+- chalk
+- ora
+- fs-extra
+
+## Generated project
+
+The generated backend starter includes:
+
+- Express server scaffold
+- Optional MongoDB config
+- JWT auth routes and middleware
+- EJS or HTML views
+- CSS starter file and public assets
+
+## Publish
+
+This package is ready for `npm link`, `npm publish`, and `npx boilerbase`.
+
+If your npm account has 2FA enabled, publish with an OTP:
+
+```bash
+npm publish --otp=123456
+```
+
+Or create a granular access token with `bypass 2fa` enabled and use that token for publishing.

package/bin/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+const path = require("path");
+const inquirer = require("inquirer");
+const chalk = require("chalk");
+const ora = require("ora");
+
+const createProject = require("../generators/createProject");
+const installDependencies = require("../generators/installDependencies");
+const openVSCode = require("../generators/openVSCode");
+const { sanitizeProjectName } = require("../utils/pathUtils");
+
+const prompts = [
+  {
+    type: "input",
+    name: "projectName",
+    message: "Project name",
+    default: "my-backend-app",
+    validate: (value) => (value.trim() ? true : "Project name is required."),
+  },
+  {
+    type: "list",
+    name: "databaseChoice",
+    message: "Select database",
+    choices: ["MongoDB", "None"],
+    default: "MongoDB",
+  },
+  {
+    type: "list",
+    name: "authenticationType",
+    message: "Select authentication",
+    choices: ["JWT", "None"],
+    default: "JWT",
+  },
+  {
+    type: "list",
+    name: "templateEngine",
+    message: "Select template engine",
+    choices: ["EJS", "HTML"],
+    default: "EJS",
+  },
+  {
+    type: "list",
+    name: "cssFramework",
+    message: "Select CSS framework",
+    choices: ["Vanilla CSS", "Bootstrap"],
+    default: "Vanilla CSS",
+  },
+  {
+    type: "confirm",
+    name: "openInVSCode",
+    message: "Open the generated folder in another VS Code Tab?",
+    default: true,
+  },
+];
+
+const run = async () => {
+  console.log(chalk.green("\n✔ Welcome to BoilerBase\n"));
+
+  const answers = await inquirer.prompt(prompts);
+  const projectName = sanitizeProjectName(answers.projectName);
+  const projectPath = path.join(process.cwd(), projectName);
+
+  const generationSpinner = ora("Generating folders and files...").start();
+
+  try {
+    await createProject({
+      projectName: answers.projectName,
+      displayProjectName: answers.projectName.trim(),
+      databaseChoice: answers.databaseChoice,
+      authenticationType: answers.authenticationType,
+      templateEngine: answers.templateEngine,
+      cssFramework: answers.cssFramework,
+      includeMVCStructure: true,
+      includeAuthSystem: answers.authenticationType === "JWT",
+      includeREADME: true,
+      targetDirectory: process.cwd(),
+    });
+
+    generationSpinner.succeed("Generating folders and files...");
+
+    const installSpinner = ora("Installing dependencies...").start();
+    await installDependencies(projectPath);
+    installSpinner.succeed("Installing dependencies...");
+
+    if (answers.openInVSCode) {
+      const openSpinner = ora("Opening VS Code...").start();
+
+      try {
+        await openVSCode(projectPath);
+        openSpinner.succeed("Opening VS Code...");
+      } catch (error) {
+        openSpinner.warn("Opening VS Code skipped");
+        console.log(chalk.yellow(`\n! ${error.message}`));
+      }
+    } else {
+      console.log(chalk.yellow("\n! Skipped opening VS Code."));
+    }
+
+    console.log(chalk.green("\n✔ Project ready successfully"));
+    console.log(chalk.cyan("\nNext steps:"));
+    console.log(chalk.white(`cd ${projectName}`));
+    console.log(chalk.white("npm run dev\n"));
+  } catch (error) {
+    generationSpinner.fail("Generation failed");
+    console.error(chalk.red(`\n✖ ${error.message}`));
+    process.exit(1);
+  }
+};
+
+run();

package/generators/createAuthFiles.js

@@ -0,0 +1,13 @@
+const {
+  buildAuthMiddlewareTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+  buildUserModelTemplate,
+} = require("./templates");
+
+module.exports = {
+  buildAuthMiddlewareTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+  buildUserModelTemplate,
+};

package/generators/createEnvFile.js

@@ -0,0 +1,3 @@
+const { buildEnvTemplate } = require("./templates");
+
+module.exports = buildEnvTemplate;

package/generators/createFiles.js

@@ -0,0 +1,71 @@
+const fs = require("fs-extra");
+const path = require("path");
+
+const {
+  buildPackageTemplate,
+  buildEnvTemplate,
+  buildDbTemplate,
+  buildHomeControllerTemplate,
+  buildIndexRouteTemplate,
+  buildServerTemplate,
+  buildAuthMiddlewareTemplate,
+  buildUserModelTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+  buildReadmeTemplate,
+  buildPublicCssTemplate,
+  buildPublicJsTemplate,
+  getViewExtension,
+  isAuthEnabled,
+  isMongoDB,
+  isMVC,
+} = require("./templates");
+
+const writeFile = async (filePath, contents) => {
+  await fs.ensureDir(path.dirname(filePath));
+  await fs.writeFile(filePath, contents, "utf8");
+};
+
+const createFiles = async (projectPath, options) => {
+  const viewExtension = getViewExtension(options);
+
+  await writeFile(path.join(projectPath, "server.js"), buildServerTemplate(options));
+  await writeFile(path.join(projectPath, "package.json"), buildPackageTemplate(options));
+  await writeFile(path.join(projectPath, ".env"), buildEnvTemplate(options));
+  await writeFile(path.join(projectPath, "config", "db.js"), buildDbTemplate(options));
+  await writeFile(path.join(projectPath, "public", "css", "style.css"), buildPublicCssTemplate(options));
+  await writeFile(path.join(projectPath, "public", "js", "main.js"), buildPublicJsTemplate(options));
+
+  if (isMVC(options)) {
+    await writeFile(path.join(projectPath, "controllers", "homeController.js"), buildHomeControllerTemplate(options));
+    await writeFile(path.join(projectPath, "routes", "index.js"), buildIndexRouteTemplate(options));
+  }
+
+  if (isAuthEnabled(options)) {
+    await writeFile(path.join(projectPath, "middleware", "authMiddleware.js"), buildAuthMiddlewareTemplate(options));
+    await writeFile(path.join(projectPath, "controllers", "authController.js"), buildAuthControllerTemplate(options));
+    await writeFile(path.join(projectPath, "routes", "authRoutes.js"), buildAuthRoutesTemplate(options));
+
+    if (isMongoDB(options)) {
+      await writeFile(path.join(projectPath, "models", "User.js"), buildUserModelTemplate(options));
+    }
+  }
+
+  await writeFile(path.join(projectPath, "views", `index.${viewExtension}`), buildIndexViewTemplate(options));
+
+  if (isAuthEnabled(options)) {
+    await writeFile(path.join(projectPath, "views", `login.${viewExtension}`), buildLoginViewTemplate(options));
+    await writeFile(path.join(projectPath, "views", `register.${viewExtension}`), buildRegisterViewTemplate(options));
+  }
+
+  if (options.includeREADME) {
+    await writeFile(path.join(projectPath, "README.md"), buildReadmeTemplate(options));
+  }
+
+  return projectPath;
+};
+
+module.exports = createFiles;

package/generators/createFolders.js

@@ -0,0 +1,20 @@
+const fs = require("fs-extra");
+const path = require("path");
+
+const { PROJECT_ROOT_FOLDERS } = require("../utils/constants");
+
+const createFolders = async (projectPath, options = {}) => {
+  const folders = [...PROJECT_ROOT_FOLDERS];
+
+  for (const folder of folders) {
+    await fs.ensureDir(path.join(projectPath, folder));
+  }
+
+  if (options.includeMVCStructure) {
+    await fs.ensureDir(path.join(projectPath, "config"));
+  }
+
+  return projectPath;
+};
+
+module.exports = createFolders;

package/generators/createMongoConfig.js

@@ -0,0 +1,3 @@
+const { buildDbTemplate } = require("./templates");
+
+module.exports = buildDbTemplate;

package/generators/createPackageJson.js

@@ -0,0 +1,3 @@
+const { buildPackageTemplate } = require("./templates");
+
+module.exports = buildPackageTemplate;

package/generators/createProject.js

@@ -0,0 +1,35 @@
+const fs = require("fs-extra");
+
+const createFolders = require("./createFolders");
+const createFiles = require("./createFiles");
+const { getProjectPath, sanitizeProjectName } = require("../utils/pathUtils");
+
+const createProject = async (options) => {
+  const displayProjectName = options.projectName.trim();
+  const projectName = sanitizeProjectName(displayProjectName);
+  const targetDirectory = options.targetDirectory || process.cwd();
+  const projectPath = getProjectPath(targetDirectory, projectName);
+
+  if (await fs.pathExists(projectPath)) {
+    const contents = await fs.readdir(projectPath);
+
+    if (contents.length > 0) {
+      throw new Error(
+        `The folder "${projectName}" already exists and is not empty.`,
+      );
+    }
+  }
+
+  await fs.ensureDir(projectPath);
+
+  await createFolders(projectPath, options);
+  await createFiles(projectPath, {
+    ...options,
+    projectName,
+    displayProjectName,
+  });
+
+  return projectPath;
+};
+
+module.exports = createProject;

package/generators/createPublicFiles.js

@@ -0,0 +1,9 @@
+const {
+  buildPublicCssTemplate,
+  buildPublicJsTemplate,
+} = require("./templates");
+
+module.exports = {
+  buildPublicCssTemplate,
+  buildPublicJsTemplate,
+};

package/generators/createReadme.js

@@ -0,0 +1,3 @@
+const { buildReadmeTemplate } = require("./templates");
+
+module.exports = buildReadmeTemplate;

package/generators/createServerFile.js

@@ -0,0 +1,3 @@
+const { buildServerTemplate } = require("./templates");
+
+module.exports = buildServerTemplate;

package/generators/createViews.js

@@ -0,0 +1,11 @@
+const {
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+} = require("./templates");
+
+module.exports = {
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+};

package/generators/installDependencies.js

@@ -0,0 +1,22 @@
+const { spawn } = require("child_process");
+
+const installDependencies = (projectPath) =>
+  new Promise((resolve, reject) => {
+    const child = spawn("npm", ["install"], {
+      cwd: projectPath,
+      stdio: "inherit",
+      shell: true,
+    });
+
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+
+      reject(new Error(`npm install failed with exit code ${code}`));
+    });
+  });
+
+module.exports = installDependencies;

package/generators/openVSCode.js

@@ -0,0 +1,18 @@
+const { spawn } = require("child_process");
+
+const openVSCode = (projectPath) =>
+  new Promise((resolve, reject) => {
+    const child = spawn("code", [projectPath], {
+      stdio: "ignore",
+      shell: true,
+      detached: true,
+    });
+
+    child.once("error", reject);
+    child.once("spawn", () => {
+      child.unref();
+      resolve();
+    });
+  });
+
+module.exports = openVSCode;

package/generators/templates.js

@@ -0,0 +1,260 @@
+const { sanitizeProjectName, toPackageName } = require("../utils/pathUtils");
+
+const isMongoDB = (options) => options.databaseChoice === "MongoDB";
+const isAuthEnabled = (options) =>
+  options.includeAuthSystem && options.authenticationType === "JWT";
+const isEJS = (options) => options.templateEngine === "EJS";
+const isBootstrap = (options) => options.cssFramework === "Bootstrap";
+const isMVC = (options) => options.includeMVCStructure;
+
+const getViewExtension = (options) => (isEJS(options) ? "ejs" : "html");
+
+const buildPackageTemplate = (options) => {
+  const dependencies = {
+    express: "^5.1.0",
+    dotenv: "^16.5.0",
+  };
+
+  if (isEJS(options)) dependencies.ejs = "^3.1.10";
+  if (isMongoDB(options)) dependencies.mongoose = "^8.15.0";
+  if (isAuthEnabled(options)) {
+    dependencies.jsonwebtoken = "^9.0.2";
+    dependencies.bcryptjs = "^3.0.2";
+  }
+
+  return JSON.stringify(
+    {
+      name: toPackageName(options.projectName),
+      version: "1.0.0",
+      description: `Starter project generated for ${options.displayProjectName || options.projectName}`,
+      main: "server.js",
+      scripts: {
+        start: "node server.js",
+        dev: "nodemon server.js",
+      },
+      dependencies,
+      devDependencies: {
+        nodemon: "^3.1.10",
+      },
+    },
+    null,
+    2,
+  );
+};
+
+const buildEnvTemplate = (options) => {
+  const lines = ["PORT=3000", "NODE_ENV=development"];
+
+  if (isMongoDB(options)) {
+    lines.push(
+      `MONGO_URI=mongodb://127.0.0.1:27017/${toPackageName(options.projectName)}`,
+    );
+  }
+
+  if (isAuthEnabled(options)) {
+    lines.push("JWT_SECRET=replace-with-a-strong-secret");
+    lines.push("JWT_EXPIRES_IN=7d");
+  }
+
+  return `${lines.join("\n")}\n`;
+};
+
+const buildDbTemplate = (options) => {
+  if (!isMongoDB(options)) {
+    return `module.exports = async function connectDB() {\n  console.log('Database not configured. Set up your own data layer when ready.');\n};\n`;
+  }
+
+  return `const mongoose = require('mongoose');\n\nconst connectDB = async () => {\n  try {\n    await mongoose.connect(process.env.MONGO_URI);\n    console.log('MongoDB connected successfully');\n  } catch (error) {\n    console.error('MongoDB connection error:', error.message);\n    process.exit(1);\n  }\n};\n\nmodule.exports = connectDB;\n`;
+};
+
+const buildHomeControllerTemplate = (options) => {
+  if (isEJS(options)) {
+    return `const renderHome = (req, res) => {\n  res.render('index', {\n    pageTitle: 'BoilerBase',\n    featureLabel: 'Developer-ready starter project',\n  });\n};\n\nmodule.exports = {\n  renderHome,\n};\n`;
+  }
+
+  return `const path = require('path');\n\nconst renderHome = (req, res) => {\n  res.sendFile(path.join(__dirname, '../views/index.html'));\n};\n\nmodule.exports = {\n  renderHome,\n};\n`;
+};
+
+const buildIndexRouteTemplate = () => {
+  return `const express = require('express');\nconst { renderHome } = require('../controllers/homeController');\n\nconst router = express.Router();\n\nrouter.get('/', renderHome);\n\nmodule.exports = router;\n`;
+};
+
+const buildServerTemplate = (options) => {
+  const lines = [
+    "require('dotenv').config();",
+    "const path = require('path');",
+    "const express = require('express');",
+  ];
+
+  if (isMongoDB(options)) {
+    lines.push("const connectDB = require('./config/db');");
+  }
+
+  if (isMVC(options)) {
+    lines.push("const homeRoutes = require('./routes/index');");
+  }
+
+  if (isAuthEnabled(options)) {
+    lines.push("const authRoutes = require('./routes/authRoutes');");
+  }
+
+  lines.push(
+    "",
+    "const app = express();",
+    "const PORT = process.env.PORT || 3000;",
+    "",
+    "app.use(express.urlencoded({ extended: true }));",
+    "app.use(express.json());",
+    "app.use(express.static(path.join(__dirname, 'public')));",
+  );
+
+  if (isEJS(options)) {
+    lines.push(
+      "app.set('view engine', 'ejs');",
+      "app.set('views', path.join(__dirname, 'views'));",
+    );
+  }
+
+  if (isMongoDB(options)) {
+    lines.push("", "connectDB();");
+  }
+
+  if (isMVC(options)) {
+    lines.push("", "app.use('/', homeRoutes);");
+  } else if (isEJS(options)) {
+    lines.push(
+      "",
+      "app.get('/', (req, res) => {",
+      "  res.render('index', {",
+      "    pageTitle: 'BoilerBase',",
+      "    featureLabel: 'Developer-ready starter project',",
+      "  });",
+      "});",
+    );
+  } else {
+    lines.push(
+      "",
+      "app.get('/', (req, res) => {",
+      "  res.sendFile(path.join(__dirname, 'views', 'index.html'));",
+      "});",
+    );
+  }
+
+  if (isAuthEnabled(options)) {
+    lines.push("app.use('/auth', authRoutes);");
+  }
+
+  lines.push(
+    "",
+    "app.get('/health', (req, res) => {",
+    "  res.json({",
+    "    status: 'ok',",
+    `    project: '${sanitizeProjectName(options.projectName)}',`,
+    "  });",
+    "});",
+    "",
+    "app.listen(PORT, () => {",
+    "  console.log('Server running on port ' + PORT);",
+    "});",
+  );
+
+  return `${lines.join("\n")}\n`;
+};
+
+const buildAuthMiddlewareTemplate = () => {
+  return `const jwt = require('jsonwebtoken');\n\nconst protectRoute = (req, res, next) => {\n  const authHeader = req.headers.authorization || '';\n  const token = authHeader.startsWith('Bearer ') ? authHeader.split(' ')[1] : null;\n\n  if (!token) {\n    return res.status(401).json({ message: 'Authentication required.' });\n  }\n\n  try {\n    req.user = jwt.verify(token, process.env.JWT_SECRET);\n    return next();\n  } catch (error) {\n    return res.status(401).json({ message: 'Invalid or expired token.' });\n  }\n};\n\nmodule.exports = {\n  protectRoute,\n};\n`;
+};
+
+const buildUserModelTemplate = () => {
+  return `const mongoose = require('mongoose');\n\nconst userSchema = new mongoose.Schema(\n  {\n    name: { type: String, required: true },\n    email: { type: String, required: true, unique: true },\n    password: { type: String, required: true },\n  },\n  { timestamps: true }\n);\n\nmodule.exports = mongoose.model('User', userSchema);\n`;
+};
+
+const buildAuthControllerTemplate = (options) => {
+  if (isMongoDB(options)) {
+    return `const bcrypt = require('bcryptjs');\nconst jwt = require('jsonwebtoken');\nconst User = require('../models/User');\n\nconst registerUser = async (req, res) => {\n  try {\n    const { name, email, password } = req.body;\n    const existingUser = await User.findOne({ email });\n\n    if (existingUser) {\n      return res.status(400).json({ message: 'User already exists.' });\n    }\n\n    const hashedPassword = await bcrypt.hash(password, 10);\n    const user = await User.create({ name, email, password: hashedPassword });\n\n    return res.status(201).json({\n      message: 'User registered successfully.',\n      user: {\n        id: user._id,\n        name: user.name,\n        email: user.email,\n      },\n    });\n  } catch (error) {\n    return res.status(500).json({ message: error.message });\n  }\n};\n\nconst loginUser = async (req, res) => {\n  try {\n    const { email, password } = req.body;\n    const user = await User.findOne({ email });\n\n    if (!user) {\n      return res.status(404).json({ message: 'User not found.' });\n    }\n\n    const passwordMatches = await bcrypt.compare(password, user.password);\n\n    if (!passwordMatches) {\n      return res.status(401).json({ message: 'Invalid credentials.' });\n    }\n\n    const token = jwt.sign(\n      { id: user._id, email: user.email },\n      process.env.JWT_SECRET,\n      { expiresIn: process.env.JWT_EXPIRES_IN || '7d' }\n    );\n\n    return res.json({ token });\n  } catch (error) {\n    return res.status(500).json({ message: error.message });\n  }\n};\n\nmodule.exports = {\n  registerUser,\n  loginUser,\n};\n`;
+  }
+
+  return `const bcrypt = require('bcryptjs');\nconst jwt = require('jsonwebtoken');\n\nconst demoUsers = [];\n\nconst registerUser = async (req, res) => {\n  try {\n    const { name, email, password } = req.body;\n    const existingUser = demoUsers.find((user) => user.email === email);\n\n    if (existingUser) {\n      return res.status(400).json({ message: 'User already exists.' });\n    }\n\n    const hashedPassword = await bcrypt.hash(password, 10);\n    const user = {\n      id: Date.now().toString(),\n      name,\n      email,\n      password: hashedPassword,\n    };\n\n    demoUsers.push(user);\n\n    return res.status(201).json({\n      message: 'User registered successfully.',\n      user: {\n        id: user.id,\n        name: user.name,\n        email: user.email,\n      },\n    });\n  } catch (error) {\n    return res.status(500).json({ message: error.message });\n  }\n};\n\nconst loginUser = async (req, res) => {\n  try {\n    const { email, password } = req.body;\n    const user = demoUsers.find((entry) => entry.email === email);\n\n    if (!user) {\n      return res.status(404).json({ message: 'User not found.' });\n    }\n\n    const passwordMatches = await bcrypt.compare(password, user.password);\n\n    if (!passwordMatches) {\n      return res.status(401).json({ message: 'Invalid credentials.' });\n    }\n\n    const token = jwt.sign(\n      { id: user.id, email: user.email },\n      process.env.JWT_SECRET,\n      { expiresIn: process.env.JWT_EXPIRES_IN || '7d' }\n    );\n\n    return res.json({ token });\n  } catch (error) {\n    return res.status(500).json({ message: error.message });\n  }\n};\n\nmodule.exports = {\n  registerUser,\n  loginUser,\n};\n`;
+};
+
+const buildAuthRoutesTemplate = () => {
+  return `const express = require('express');\nconst { registerUser, loginUser } = require('../controllers/authController');\nconst { protectRoute } = require('../middleware/authMiddleware');\n\nconst router = express.Router();\n\nrouter.post('/register', registerUser);\nrouter.post('/login', loginUser);\nrouter.get('/profile', protectRoute, (req, res) => {\n  res.json({\n    message: 'Protected route reached successfully.',\n    user: req.user,\n  });\n});\n\nmodule.exports = router;\n`;
+};
+
+const buildIndexViewTemplate = (options) => {
+  const bootstrapLink = isBootstrap(options)
+    ? `  <link href='https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css' rel='stylesheet'>\n`
+    : "";
+  const actionCopy = isEJS(options)
+    ? `<span><%= featureLabel %></span>`
+    : `<span>Developer-ready starter project</span>`;
+
+  if (isEJS(options)) {
+    return `<!DOCTYPE html>\n<html lang='en'>\n<head>\n  <meta charset='UTF-8'>\n  <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n  <title><%= pageTitle %></title>\n${bootstrapLink}  <link rel='stylesheet' href='/css/style.css'>\n</head>\n<body>\n  <main class='page-shell'>\n    <section class='hero-card'>\n      <div class='hero-badge'>BoilerBase Starter</div>\n      <h1>Project scaffold ready in seconds.</h1>\n      <p>${actionCopy}</p>\n      <div class='hero-grid'>\n        <article>\n          <strong>MongoDB-ready</strong>\n          <span>Config, models, and environment setup included.</span>\n        </article>\n        <article>\n          <strong>Auth-friendly</strong>\n          <span>JWT routes and middleware are scaffolded when enabled.</span>\n        </article>\n        <article>\n          <strong>Responsive UI</strong>\n          <span>Built with a polished, mobile-ready starter layout.</span>\n        </article>\n      </div>\n    </section>\n  </main>\n  <script src='/js/main.js'></script>\n</body>\n</html>\n`;
+  }
+
+  return `<!DOCTYPE html>\n<html lang='en'>\n<head>\n  <meta charset='UTF-8'>\n  <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n  <title>BoilerBase</title>\n${bootstrapLink}  <link rel='stylesheet' href='/css/style.css'>\n</head>\n<body>\n  <main class='page-shell'>\n    <section class='hero-card'>\n      <div class='hero-badge'>BoilerBase Starter</div>\n      <h1>Project scaffold ready in seconds.</h1>\n      <p>Developer-ready starter project</p>\n      <div class='hero-grid'>\n        <article>\n          <strong>MongoDB-ready</strong>\n          <span>Config, models, and environment setup included.</span>\n        </article>\n        <article>\n          <strong>Auth-friendly</strong>\n          <span>JWT routes and middleware are scaffolded when enabled.</span>\n        </article>\n        <article>\n          <strong>Responsive UI</strong>\n          <span>Built with a polished, mobile-ready starter layout.</span>\n        </article>\n      </div>\n    </section>\n  </main>\n  <script src='/js/main.js'></script>\n</body>\n</html>\n`;
+};
+
+const buildLoginViewTemplate = (options) => {
+  if (!isEJS(options)) {
+    return `<!DOCTYPE html>\n<html lang='en'>\n<head>\n  <meta charset='UTF-8'>\n  <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n  <title>Login</title>\n  <link rel='stylesheet' href='/css/style.css'>\n</head>\n<body>\n  <section class='auth-card'>\n    <h1>Login</h1>\n    <p>Connect this form to your auth API.</p>\n  </section>\n</body>\n</html>\n`;
+  }
+
+  return `<section class='auth-card'>\n  <h1>Login</h1>\n  <p>Connect this form to your auth API.</p>\n</section>\n`;
+};
+
+const buildRegisterViewTemplate = (options) => {
+  if (!isEJS(options)) {
+    return `<!DOCTYPE html>\n<html lang='en'>\n<head>\n  <meta charset='UTF-8'>\n  <meta name='viewport' content='width=device-width, initial-scale=1.0'>\n  <title>Register</title>\n  <link rel='stylesheet' href='/css/style.css'>\n</head>\n<body>\n  <section class='auth-card'>\n    <h1>Register</h1>\n    <p>Connect this form to your auth API.</p>\n  </section>\n</body>\n</html>\n`;
+  }
+
+  return `<section class='auth-card'>\n  <h1>Register</h1>\n  <p>Connect this form to your auth API.</p>\n</section>\n`;
+};
+
+const buildReadmeTemplate = (options) => {
+  const features = [
+    "- Express server scaffold",
+    `- ${options.databaseChoice} data layer`,
+    `- ${options.authenticationType} authentication scaffold`,
+    `- ${options.templateEngine} templating`,
+    `- ${options.cssFramework} styling`,
+  ];
+
+  return `# ${options.displayProjectName || options.projectName}\n\nGenerated by BoilerBase CLI.\n\n## Included\n${features.join("\n")}\n\n## Run\n\`\`\`bash\nnpm install\nnpm run dev\n\`\`\`\n`;
+};
+
+const buildPublicCssTemplate = (options) => {
+  const frameworkAccent = isBootstrap(options) ? "#7dd3fc" : "#8b5cf6";
+
+  return `:root {\n  color-scheme: dark;\n  --bg: #07111f;\n  --panel: rgba(12, 18, 33, 0.88);\n  --panel-border: rgba(148, 163, 184, 0.18);\n  --text: #e2e8f0;\n  --muted: #94a3b8;\n  --accent: ${frameworkAccent};\n  --accent-2: #22d3ee;\n  --shadow: 0 30px 80px rgba(0, 0, 0, 0.35);\n}\n\n* {\n  box-sizing: border-box;\n}\n\nbody {\n  margin: 0;\n  min-height: 100vh;\n  font-family: Inter, Segoe UI, Arial, sans-serif;\n  color: var(--text);\n  background:\n    radial-gradient(circle at top left, rgba(34, 211, 238, 0.16), transparent 28%),\n    radial-gradient(circle at top right, rgba(139, 92, 246, 0.18), transparent 24%),\n    linear-gradient(180deg, #040812 0%, #07111f 100%);\n}\n\nbody::before {\n  content: '';\n  position: fixed;\n  inset: 0;\n  background-image: linear-gradient(rgba(255,255,255,0.02) 1px, transparent 1px), linear-gradient(90deg, rgba(255,255,255,0.02) 1px, transparent 1px);\n  background-size: 36px 36px;\n  pointer-events: none;\n  opacity: 0.35;\n}\n\n.page-shell {\n  position: relative;\n  z-index: 1;\n  min-height: 100vh;\n  display: grid;\n  place-items: center;\n  padding: 40px 20px;\n}\n\n.hero-card,\n.auth-card {\n  width: min(1100px, 100%);\n  background: var(--panel);\n  border: 1px solid var(--panel-border);\n  box-shadow: var(--shadow);\n  backdrop-filter: blur(20px);\n  border-radius: 28px;\n  padding: clamp(28px, 5vw, 56px);\n}\n\n.hero-badge {\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n  padding: 10px 14px;\n  border-radius: 999px;\n  background: rgba(34, 211, 238, 0.12);\n  color: #cffafe;\n  border: 1px solid rgba(34, 211, 238, 0.22);\n  font-size: 0.85rem;\n  letter-spacing: 0.08em;\n  text-transform: uppercase;\n}\n\nh1 {\n  margin: 20px 0 12px;\n  font-size: clamp(2.4rem, 5vw, 4.8rem);\n  line-height: 0.95;\n}\n\np {\n  margin: 0;\n  max-width: 60ch;\n  color: var(--muted);\n  font-size: 1.05rem;\n}\n\n.hero-grid {\n  display: grid;\n  grid-template-columns: repeat(3, minmax(0, 1fr));\n  gap: 18px;\n  margin-top: 32px;\n}\n\n.hero-grid article {\n  padding: 20px;\n  border-radius: 20px;\n  background: rgba(15, 23, 42, 0.66);\n  border: 1px solid rgba(148, 163, 184, 0.14);\n}\n\n.hero-grid strong {\n  display: block;\n  margin-bottom: 8px;\n  color: white;\n}\n\n.hero-grid span {\n  color: var(--muted);\n  line-height: 1.6;\n}\n\n@media (max-width: 900px) {\n  .hero-grid {\n    grid-template-columns: 1fr;\n  }\n}\n`;
+};
+
+const buildPublicJsTemplate = () => {
+  return `document.addEventListener('DOMContentLoaded', () => {\n  document.body.classList.add('is-ready');\n\n  const cards = document.querySelectorAll('.hero-grid article, .form-card, .stats-card');\n  cards.forEach((card, index) => {\n    card.style.animationDelay = String(index * 90) + 'ms';\n    card.classList.add('reveal');\n  });\n});\n`;
+};
+
+module.exports = {
+  buildPackageTemplate,
+  buildEnvTemplate,
+  buildDbTemplate,
+  buildHomeControllerTemplate,
+  buildIndexRouteTemplate,
+  buildServerTemplate,
+  buildAuthMiddlewareTemplate,
+  buildUserModelTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+  buildReadmeTemplate,
+  buildPublicCssTemplate,
+  buildPublicJsTemplate,
+  getViewExtension,
+  isMongoDB,
+  isAuthEnabled,
+  isEJS,
+  isBootstrap,
+  isMVC,
+};

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "boilerbase",
+  "version": "1.0.1",
+  "description": "A minimal developer CLI for generating backend starter projects",
+  "main": "./bin/index.js",
+  "bin": {
+    "boilerbase": "./bin/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin",
+    "generators",
+    "templates",
+    "utils",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node ./bin/index.js"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.3.0",
+    "inquirer": "^8.2.7",
+    "ora": "^5.4.1"
+  }
+}

package/templates/authTemplate.js

@@ -0,0 +1,11 @@
+const {
+  buildAuthMiddlewareTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+} = require("../generators/templates");
+
+module.exports = {
+  buildAuthMiddlewareTemplate,
+  buildAuthControllerTemplate,
+  buildAuthRoutesTemplate,
+};

package/templates/cssTemplate.js

@@ -0,0 +1,5 @@
+const {
+  buildPublicCssTemplate,
+} = require("../generators/templates");
+
+module.exports = buildPublicCssTemplate;

package/templates/dbTemplate.js

@@ -0,0 +1,3 @@
+const { buildDbTemplate } = require("../generators/templates");
+
+module.exports = buildDbTemplate;

package/templates/envTemplate.js

@@ -0,0 +1,3 @@
+const { buildEnvTemplate } = require("../generators/templates");
+
+module.exports = buildEnvTemplate;

package/templates/modelTemplate.js

@@ -0,0 +1,3 @@
+const { buildUserModelTemplate } = require("../generators/templates");
+
+module.exports = buildUserModelTemplate;

package/templates/packageTemplate.js

@@ -0,0 +1,3 @@
+const { buildPackageTemplate } = require("../generators/templates");
+
+module.exports = buildPackageTemplate;

package/templates/readmeTemplate.js

@@ -0,0 +1,3 @@
+const { buildReadmeTemplate } = require("../generators/templates");
+
+module.exports = buildReadmeTemplate;

package/templates/routeTemplate.js

@@ -0,0 +1,9 @@
+const {
+  buildIndexRouteTemplate,
+  buildAuthRoutesTemplate,
+} = require("../generators/templates");
+
+module.exports = {
+  buildIndexRouteTemplate,
+  buildAuthRoutesTemplate,
+};

package/templates/serverTemplate.js

@@ -0,0 +1,3 @@
+const { buildServerTemplate } = require("../generators/templates");
+
+module.exports = buildServerTemplate;

package/templates/viewTemplate.js

@@ -0,0 +1,11 @@
+const {
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+} = require("../generators/templates");
+
+module.exports = {
+  buildIndexViewTemplate,
+  buildLoginViewTemplate,
+  buildRegisterViewTemplate,
+};

package/utils/constants.js

@@ -0,0 +1,23 @@
+const PROJECT_ROOT_FOLDERS = [
+  "config",
+  "controllers",
+  "middleware",
+  "models",
+  "routes",
+  "views",
+  "public",
+  "public/css",
+  "public/js",
+];
+
+const FORM_DEFAULTS = {
+  databaseChoice: "MongoDB",
+  authenticationType: "JWT",
+  templateEngine: "EJS",
+  cssFramework: "Vanilla CSS",
+};
+
+module.exports = {
+  PROJECT_ROOT_FOLDERS,
+  FORM_DEFAULTS,
+};

package/utils/helper.js

@@ -0,0 +1,29 @@
+const { FORM_DEFAULTS } = require("./constants");
+
+const normalizeOptions = (body = {}) => {
+  const projectName = (body.projectName || "").trim();
+
+  return {
+    projectName,
+    databaseChoice: body.databaseChoice || FORM_DEFAULTS.databaseChoice,
+    authenticationType: body.authenticationType || FORM_DEFAULTS.authenticationType,
+    templateEngine: body.templateEngine || FORM_DEFAULTS.templateEngine,
+    cssFramework: body.cssFramework || FORM_DEFAULTS.cssFramework,
+    includeMVCStructure: body.includeMVCStructure === "on" || body.includeMVCStructure === "true",
+    includeAuthSystem: body.includeAuthSystem === "on" || body.includeAuthSystem === "true",
+    includeREADME: body.includeREADME === "on" || body.includeREADME === "true",
+  };
+};
+
+const validateOptions = (options) => {
+  if (!options.projectName) {
+    return "Project name is required.";
+  }
+
+  return null;
+};
+
+module.exports = {
+  normalizeOptions,
+  validateOptions,
+};

package/utils/pathUtils.js

@@ -0,0 +1,23 @@
+const path = require("path");
+
+const sanitizeProjectName = (value = "") => {
+  const cleaned = value
+    .trim()
+    .replace(/[^a-zA-Z0-9\s-_]/g, "")
+    .replace(/\s+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+
+  return cleaned || "my-app";
+};
+
+const toPackageName = (value = "") => sanitizeProjectName(value).toLowerCase();
+
+const getProjectPath = (baseDir, projectName) =>
+  path.join(baseDir, sanitizeProjectName(projectName));
+
+module.exports = {
+  sanitizeProjectName,
+  toPackageName,
+  getProjectPath,
+};