boilercraft 1.0.0

package/stacks/nextjs/overlays/router-pages/src/pages/_document.js

@@ -0,0 +1,13 @@
+import { Html, Head, Main, NextScript } from 'next/document';
+
+export default function Document() {
+  return (
+    <Html lang="en" data-theme="{{COLOR_MODE}}">
+      <Head />
+      <body>
+        <Main />
+        <NextScript />
+      </body>
+    </Html>
+  );
+}

package/stacks/nextjs/overlays/router-pages/src/pages/api/health.js

@@ -0,0 +1,8 @@
+export default function handler(req, res) {
+  res.status(200).json({
+    status: 'online',
+    stack: 'Next.js {{VERSION}} Pages Router',
+    database: '{{DB_TYPE}}',
+    appName: {{APP_TITLE_JS}}
+  });
+}

package/stacks/nextjs/overlays/router-pages/src/pages/index.js

@@ -0,0 +1,27 @@
+import Head from 'next/head';
+
+export default function Home() {
+  return (
+    <>
+      <Head>
+        <title>{{{APP_TITLE_JS}}}</title>
+        <meta name="description" content={{{APP_DESC_JS}}} />
+      </Head>
+      <div style={{ maxWidth: '900px', margin: '3rem auto', padding: '1rem', textAlign: 'center' }}>
+        <h1 style={{ fontSize: '2.5rem', fontWeight: 800 }}>{{APP_TITLE}}</h1>
+        <p style={{ color: 'var(--color-text-muted)' }}>{{APP_DESC}}</p>
+
+        <div style={{ marginTop: '2rem', padding: '1.5rem', background: 'var(--color-surface)', borderRadius: '1rem', textAlign: 'left', border: '1px solid var(--color-border)' }}>
+          <h3>Configured Architecture:</h3>
+          <ul>
+            <li><strong>Framework:</strong> Next.js {{VERSION}} (Pages Router)</li>
+            <li><strong>Database:</strong> {{DATABASE}}</li>
+            <li><strong>Styling:</strong> {{STYLING}}</li>
+            <li><strong>Theme:</strong> {{THEME}}</li>
+          </ul>
+          <p>Health API: <a href="/api/health" style={{ color: 'var(--color-primary)' }}>/api/health</a></p>
+        </div>
+      </div>
+    </>
+  );
+}

package/stacks/nextjs/stack.json

@@ -0,0 +1,257 @@
+{
+  "id": "nextjs",
+  "name": "Next.js",
+  "defaultPort": 3000,
+  "databases": [
+    "mongodb",
+    "mysql",
+    "mssql"
+  ],
+  "stylings": [
+    "tailwind",
+    "bootstrap",
+    "vanilla"
+  ],
+  "options": [
+    {
+      "id": "router",
+      "label": "Router",
+      "default": "app",
+      "choices": [
+        {
+          "value": "app",
+          "label": "App Router",
+          "hint": "recommended · Server Components · layouts"
+        },
+        {
+          "value": "pages",
+          "label": "Pages Router",
+          "hint": "classic · getServerSideProps · API routes"
+        }
+      ]
+    }
+  ],
+  "nextSteps": [
+    "npm run dev"
+  ],
+  "versions": {
+    "source": "npm",
+    "package": "next",
+    "minMajor": 14,
+    "testedUpTo": 16,
+    "offline": [
+      16,
+      15,
+      14
+    ]
+  },
+  "requires": [
+    {
+      "cmd": "node",
+      "name": "Node.js",
+      "install": "https://nodejs.org"
+    },
+    {
+      "cmd": "npx",
+      "name": "npx",
+      "install": "Ships with Node.js"
+    }
+  ],
+  "steps": [
+    {
+      "label": "Running official create-next-app@{{VERSION}}",
+      "cwd": "parent",
+      "run": [
+        "npx",
+        "--yes",
+        "create-next-app@{{VERSION}}",
+        "{{PROJECT_NAME}}",
+        "--js",
+        "{{NEXT_ROUTER_FLAG}}",
+        "--src-dir",
+        "--eslint",
+        "--use-npm",
+        "--import-alias",
+        "@/*",
+        "{{NEXT_TAILWIND_FLAG}}"
+      ]
+    },
+    {
+      "when": {
+        "database": "mongodb"
+      },
+      "run": [
+        "npm",
+        "install",
+        "mongoose"
+      ]
+    },
+    {
+      "when": {
+        "database": "mysql"
+      },
+      "run": [
+        "npm",
+        "install",
+        "mysql2"
+      ]
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "run": [
+        "npm",
+        "install",
+        "mssql"
+      ]
+    },
+    {
+      "when": {
+        "styling": "bootstrap"
+      },
+      "run": [
+        "npm",
+        "install",
+        "bootstrap"
+      ]
+    },
+    {
+      "when": {
+        "auth": true
+      },
+      "run": [
+        "npm",
+        "install",
+        "jsonwebtoken",
+        "bcryptjs"
+      ]
+    },
+    {
+      "json": "package.json",
+      "merge": {
+        "scripts": {
+          "dev": "next dev -p {{PORT}}",
+          "start": "next start -p {{PORT}}"
+        }
+      }
+    },
+    {
+      "label": "Applying BoilerCraft overlay",
+      "copy": "overlays/common"
+    },
+    {
+      "when": {
+        "router": "app"
+      },
+      "copy": "overlays/router-app"
+    },
+    {
+      "when": {
+        "router": "pages"
+      },
+      "copy": "overlays/router-pages"
+    },
+    {
+      "when": {
+        "database": "mongodb"
+      },
+      "copy": "overlays/db/mongodb"
+    },
+    {
+      "when": {
+        "database": "mysql"
+      },
+      "copy": "overlays/db/mysql"
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "copy": "overlays/db/mssql"
+    },
+    {
+      "when": {
+        "auth": true
+      },
+      "copy": "overlays/auth"
+    },
+    {
+      "when": {
+        "auth": true,
+        "router": "app"
+      },
+      "copy": "overlays/auth-app"
+    },
+    {
+      "when": {
+        "auth": true,
+        "router": "pages"
+      },
+      "copy": "overlays/auth-pages"
+    },
+    {
+      "when": {
+        "styling": "bootstrap",
+        "router": "app"
+      },
+      "write": "src/styles/vendor.js",
+      "content": "import 'bootstrap/dist/css/bootstrap.min.css';\n"
+    },
+    {
+      "when": {
+        "styling": [
+          "tailwind",
+          "vanilla"
+        ],
+        "router": "app"
+      },
+      "write": "src/styles/vendor.js",
+      "content": "// No vendor stylesheet for this styling option.\n"
+    },
+    {
+      "write": "src/styles/theme.css",
+      "content": "{{THEME_CSS}}"
+    }
+  ],
+  "vars": [
+    {
+      "name": "NEXT_ROUTER_FLAG",
+      "when": {
+        "router": "app"
+      },
+      "value": "--app"
+    },
+    {
+      "name": "NEXT_ROUTER_FLAG",
+      "when": {
+        "router": "pages"
+      },
+      "value": "--no-app"
+    },
+    {
+      "name": "NEXT_TAILWIND_FLAG",
+      "when": {
+        "styling": "tailwind"
+      },
+      "value": "--tailwind"
+    },
+    {
+      "name": "NEXT_TAILWIND_FLAG",
+      "when": {
+        "styling": [
+          "bootstrap",
+          "vanilla"
+        ]
+      },
+      "value": "--no-tailwind"
+    },
+    {
+      "name": "PAGES_VENDOR_CSS",
+      "when": {
+        "styling": "bootstrap"
+      },
+      "value": "import 'bootstrap/dist/css/bootstrap.min.css';"
+    }
+  ]
+}

package/stacks/node-express/overlays/auth/src/controllers/authController.js

@@ -0,0 +1,53 @@
+const bcrypt = require('bcryptjs');
+const jwt = require('jsonwebtoken');
+const { JWT_SECRET } = require('../middlewares/auth');
+
+// In-memory or dynamic model fallback
+let usersTable = [];
+
+exports.register = async (req, res) => {
+  const { name, email, password, role = 'user' } = req.body;
+  if (!name || !email || !password) {
+    return res.status(400).json({ success: false, error: 'Name, email, and password required.' });
+  }
+
+  const existing = usersTable.find(u => u.email === email);
+  if (existing) {
+    return res.status(409).json({ success: false, error: 'User already exists.' });
+  }
+
+  const hashedPassword = await bcrypt.hash(password, 10);
+  const newUser = { id: usersTable.length + 1, name, email, password: hashedPassword, role };
+  usersTable.push(newUser);
+
+  const token = jwt.sign({ id: newUser.id, name: newUser.name, email: newUser.email, role: newUser.role }, JWT_SECRET, { expiresIn: '7d' });
+
+  res.status(201).json({
+    success: true,
+    message: 'User registered successfully',
+    token,
+    user: { id: newUser.id, name: newUser.name, email: newUser.email, role: newUser.role }
+  });
+};
+
+exports.login = async (req, res) => {
+  const { email, password } = req.body;
+  const user = usersTable.find(u => u.email === email);
+
+  if (!user || !(await bcrypt.compare(password, user.password))) {
+    return res.status(401).json({ success: false, error: 'Invalid credentials.' });
+  }
+
+  const token = jwt.sign({ id: user.id, name: user.name, email: user.email, role: user.role }, JWT_SECRET, { expiresIn: '7d' });
+
+  res.json({
+    success: true,
+    message: 'Login successful',
+    token,
+    user: { id: user.id, name: user.name, email: user.email, role: user.role }
+  });
+};
+
+exports.getProfile = (req, res) => {
+  res.json({ success: true, user: req.user });
+};

package/stacks/node-express/overlays/auth/src/middlewares/auth.js

@@ -0,0 +1,36 @@
+const jwt = require('jsonwebtoken');
+
+const JWT_SECRET = process.env.JWT_SECRET || 'super_secret_jwt_key_boiler_craft_2026';
+
+function auth(req, res, next) {
+  const authHeader = req.headers['authorization'];
+  const token = authHeader && authHeader.split(' ')[1];
+
+  if (!token) {
+    return res.status(401).json({ success: false, error: 'Access denied. No token provided.' });
+  }
+
+  try {
+    const decoded = jwt.verify(token, JWT_SECRET);
+    req.user = decoded;
+    next();
+  } catch (err) {
+    return res.status(403).json({ success: false, error: 'Invalid or expired token.' });
+  }
+}
+
+function role(allowedRoles = []) {
+  if (typeof allowedRoles === 'string') allowedRoles = [allowedRoles];
+
+  return (req, res, next) => {
+    if (!req.user) {
+      return res.status(401).json({ success: false, error: 'Unauthenticated.' });
+    }
+    if (!allowedRoles.includes(req.user.role)) {
+      return res.status(403).json({ success: false, error: 'Forbidden. Insufficient permissions.' });
+    }
+    next();
+  };
+}
+
+module.exports = { auth, role, JWT_SECRET };

package/stacks/node-express/overlays/auth/src/routes/authRoutes.js

@@ -0,0 +1,16 @@
+const express = require('express');
+const router = express.Router();
+const { register, login, getProfile } = require('../controllers/authController');
+const { auth, role } = require('../middlewares/auth');
+
+// Public
+router.post('/register', register);
+router.post('/login', login);
+
+// Protected Routes
+router.get('/profile', auth, getProfile);
+router.get('/admin', auth, role('admin'), (req, res) => {
+  res.json({ success: true, message: 'Welcome to Admin Authorized Area!', user: req.user });
+});
+
+module.exports = router;

package/stacks/node-express/overlays/common/.env.example

@@ -0,0 +1,5 @@
+PORT={{PORT}}
+APP_NAME={{APP_TITLE_JS}}
+NODE_ENV=development
+JWT_SECRET=change-me
+{{DB_ENV_EXAMPLE}}

package/stacks/node-express/overlays/common/public/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="{{COLOR_MODE}}">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{APP_TITLE}}</title>
+  <link rel="stylesheet" href="/theme.css">
+  {{STYLESHEET_LINK}}
+</head>
+<body class="p-6">
+  <div style="max-width: 850px; margin: 2rem auto; text-align: center;">
+    {{LOGO_HTML}}
+    <h1>{{APP_TITLE}}</h1>
+    <p style="color: var(--color-text-muted);">{{APP_DESC}}</p>
+
+    <div style="text-align: left; padding: 2rem; background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-base); margin-top: 2rem;">
+      <h3>Active Architecture:</h3>
+      <ul>
+        <li><strong>Backend:</strong> Node.js + Express {{VERSION}}.x</li>
+        <li><strong>Database:</strong> {{DATABASE}}</li>
+        <li><strong>Styling:</strong> {{STYLING}}</li>
+      </ul>
+      <p>Health API: <a href="/api/health">/api/health</a></p>
+      <hr style="border: none; border-top: 1px solid var(--color-border); margin: 1.5rem 0;" />
+      <h4>Components:</h4>
+      {{UI_COMPONENTS}}
+    </div>
+  </div>
+  <script src="/theme.js"></script>
+</body>
+</html>

package/stacks/node-express/overlays/common/src/server.js

@@ -0,0 +1,32 @@
+const express = require('express');
+const cors = require('cors');
+const path = require('path');
+require('dotenv').config();
+const { connectDB } = require('./db');
+{{AUTH_REQUIRE}}
+
+const app = express();
+const PORT = process.env.PORT || {{PORT}};
+
+app.use(cors());
+app.use(express.json());
+app.use(express.static(path.join(__dirname, '../public')));
+
+connectDB();
+
+// API Endpoints
+{{AUTH_MOUNT}}
+
+app.get('/api/health', (req, res) => {
+  res.json({
+    status: 'online',
+    app: {{APP_TITLE_JS}},
+    database: '{{DB_TYPE}}',
+    express: require('express/package.json').version,
+    auth: {{AUTH_ENABLED}}
+  });
+});
+
+app.listen(PORT, () => {
+  console.log(`⚡ Server listening at http://localhost:${PORT}`);
+});

package/stacks/node-express/overlays/db/mongodb/src/db.js

@@ -0,0 +1,13 @@
+const mongoose = require('mongoose');
+
+async function connectDB() {
+  const uri = process.env.MONGODB_URI || 'mongodb://127.0.0.1:27017/{{DB_NAME}}';
+  try {
+    await mongoose.connect(uri);
+    console.log('⚡ Connected to MongoDB (Mongoose)');
+  } catch (err) {
+    console.error('❌ MongoDB Connection Error:', err.message);
+  }
+}
+
+module.exports = { connectDB };

package/stacks/node-express/overlays/db/mssql/src/db.js

@@ -0,0 +1,22 @@
+const sql = require('mssql');
+
+const config = {
+  user: process.env.DB_USERNAME || 'sa',
+  password: process.env.DB_PASSWORD || '',
+  server: process.env.DB_HOST || 'localhost',
+  database: process.env.DB_DATABASE || '{{DB_NAME}}',
+  port: parseInt(process.env.DB_PORT || '1433', 10),
+  options: { encrypt: false, trustServerCertificate: true }
+};
+
+async function connectDB() {
+  try {
+    const pool = await sql.connect(config);
+    console.log('⚡ Connected to MSSQL (SQL Server)');
+    return pool;
+  } catch (err) {
+    console.error('❌ MSSQL Connection Error:', err.message);
+  }
+}
+
+module.exports = { connectDB, sql };

package/stacks/node-express/overlays/db/mysql/src/db.js

@@ -0,0 +1,22 @@
+const mysql = require('mysql2/promise');
+
+let pool;
+
+async function connectDB() {
+  try {
+    pool = mysql.createPool({
+      host: process.env.DB_HOST || '127.0.0.1',
+      user: process.env.DB_USERNAME || 'root',
+      password: process.env.DB_PASSWORD || '',
+      database: process.env.DB_DATABASE || '{{DB_NAME}}',
+      port: parseInt(process.env.DB_PORT || '3306', 10)
+    });
+    await pool.query('SELECT 1');
+    console.log('⚡ Connected to MySQL');
+  } catch (err) {
+    console.error('❌ MySQL Connection Error:', err.message);
+  }
+  return pool;
+}
+
+module.exports = { connectDB, getPool: () => pool };