boilercraft 1.0.0

package/stacks/laravel/stack.json

@@ -0,0 +1,477 @@
+{
+  "id": "laravel",
+  "name": "Laravel",
+  "aliases": [
+    "laravel-vue-mysql"
+  ],
+  "defaultPort": 8000,
+  "databases": [
+    "mysql",
+    "mssql"
+  ],
+  "stylings": [
+    "tailwind",
+    "bootstrap",
+    "vanilla"
+  ],
+  "options": [
+    {
+      "id": "frontend",
+      "label": "Frontend",
+      "default": "blade",
+      "choices": [
+        {
+          "value": "blade",
+          "label": "Blade",
+          "hint": "server-rendered · classic Laravel"
+        },
+        {
+          "value": "vue",
+          "label": "Vue 3 (Inertia)",
+          "hint": "SPA feel, Laravel routing"
+        },
+        {
+          "value": "react",
+          "label": "React (Inertia)",
+          "hint": "SPA feel, Laravel routing"
+        }
+      ]
+    }
+  ],
+  "nextSteps": [
+    "php artisan migrate",
+    "php artisan serve --port={{PORT}}"
+  ],
+  "versions": {
+    "source": "packagist",
+    "package": "laravel/laravel",
+    "minMajor": 10,
+    "testedUpTo": 13,
+    "offline": [
+      13,
+      12,
+      11,
+      10
+    ]
+  },
+  "requires": [
+    {
+      "cmd": "php",
+      "args": [
+        "-v"
+      ],
+      "name": "PHP",
+      "install": "https://www.php.net/downloads (or XAMPP / WAMP / Laragon / Herd)"
+    },
+    {
+      "cmd": "composer",
+      "name": "Composer",
+      "install": "https://getcomposer.org/download/"
+    }
+  ],
+  "steps": [
+    {
+      "label": "Running official composer create-project laravel/laravel:^{{VERSION}}.0",
+      "cwd": "parent",
+      "run": [
+        "composer",
+        "create-project",
+        "laravel/laravel:^{{VERSION}}.0",
+        "{{PROJECT_NAME}}",
+        "--prefer-dist",
+        "--no-interaction"
+      ]
+    },
+    {
+      "env": {
+        "APP_NAME": "{{APP_TITLE_JS}}"
+      }
+    },
+    {
+      "when": {
+        "database": "mysql"
+      },
+      "env": {
+        "DB_CONNECTION": "mysql",
+        "DB_HOST": "127.0.0.1",
+        "DB_PORT": "3306",
+        "DB_DATABASE": "{{DB_NAME}}",
+        "DB_USERNAME": "root",
+        "DB_PASSWORD": ""
+      }
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "env": {
+        "DB_CONNECTION": "sqlsrv",
+        "DB_HOST": "127.0.0.1",
+        "DB_PORT": "1433",
+        "DB_DATABASE": "{{DB_NAME}}",
+        "DB_USERNAME": "sa"
+      }
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "env": {
+        "DB_PASSWORD": "{{RANDOM_PASSWORD}}"
+      },
+      "files": [
+        ".env"
+      ]
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "env": {
+        "DB_PASSWORD": "change-me"
+      },
+      "files": [
+        ".env.example"
+      ]
+    },
+    {
+      "label": "Applying BoilerCraft overlay",
+      "copy": "overlays/common",
+      "when": {
+        "frontend": "blade"
+      }
+    },
+    {
+      "write": "public/css/boilercraft-theme.css",
+      "content": "{{THEME_CSS}}"
+    },
+    {
+      "write": "public/js/boilercraft-theme.js",
+      "content": "{{THEME_JS}}"
+    },
+    {
+      "append": "routes/web.php",
+      "from": "snippets/web-routes.php",
+      "when": {
+        "frontend": "blade"
+      }
+    },
+    {
+      "label": "Installing API scaffolding (Sanctum) via php artisan install:api",
+      "when": {
+        "auth": true,
+        "version": ">=11",
+        "frontend": "blade"
+      },
+      "run": [
+        "php",
+        "artisan",
+        "install:api",
+        "--no-interaction",
+        "--without-migration-prompt"
+      ]
+    },
+    {
+      "when": {
+        "auth": true,
+        "version": ">=11",
+        "frontend": "blade"
+      },
+      "replace": "app/Models/User.php",
+      "skipIfContains": "HasApiTokens",
+      "find": "use HasFactory, Notifiable;",
+      "with": "use \\Laravel\\Sanctum\\HasApiTokens, HasFactory, Notifiable;"
+    },
+    {
+      "when": {
+        "auth": true,
+        "frontend": "blade"
+      },
+      "copy": "overlays/auth"
+    },
+    {
+      "when": {
+        "auth": true,
+        "frontend": "blade"
+      },
+      "append": "routes/api.php",
+      "from": "snippets/api-routes.php"
+    },
+    {
+      "label": "Installing Laravel Breeze ({{OPTION_FRONTEND}}) with authentication",
+      "when": {
+        "auth": true,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "run": [
+        "composer",
+        "require",
+        "laravel/breeze",
+        "--dev",
+        "--no-interaction"
+      ]
+    },
+    {
+      "label": "Running php artisan breeze:install {{OPTION_FRONTEND}}",
+      "when": {
+        "auth": true,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "run": [
+        "php",
+        "artisan",
+        "breeze:install",
+        "{{OPTION_FRONTEND}}",
+        "--no-interaction"
+      ]
+    },
+    {
+      "label": "Installing Inertia (server side)",
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "run": [
+        "composer",
+        "require",
+        "inertiajs/inertia-laravel",
+        "--no-interaction"
+      ]
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "run": [
+        "php",
+        "artisan",
+        "inertia:middleware",
+        "--no-interaction"
+      ]
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ],
+        "version": ">=11"
+      },
+      "replace": "bootstrap/app.php",
+      "skipIfContains": "HandleInertiaRequests",
+      "findRegex": "->withMiddleware\\(function \\(Middleware \\$middleware\\)(: void)? \\{",
+      "with": "$&\n        $middleware->web(append: [\\App\\Http\\Middleware\\HandleInertiaRequests::class]);"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ],
+        "version": "<11"
+      },
+      "replace": "app/Http/Kernel.php",
+      "skipIfContains": "HandleInertiaRequests",
+      "find": "'web' => [",
+      "with": "$&\n            \\App\\Http\\Middleware\\HandleInertiaRequests::class,"
+    },
+    {
+      "label": "Installing Vue 3 + Inertia (client side)",
+      "when": {
+        "auth": false,
+        "frontend": "vue"
+      },
+      "run": [
+        "npm",
+        "install",
+        "-D",
+        "{{VITE_PLUGIN_VUE}}",
+        "vue",
+        "@inertiajs/vue3"
+      ]
+    },
+    {
+      "label": "Installing React + Inertia (client side)",
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "run": [
+        "npm",
+        "install",
+        "-D",
+        "{{VITE_PLUGIN_REACT}}",
+        "react",
+        "react-dom",
+        "@inertiajs/react"
+      ]
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "vue"
+      },
+      "replace": "vite.config.js",
+      "skipIfContains": "@vitejs/plugin-vue",
+      "find": "import laravel from 'laravel-vite-plugin';",
+      "with": "import laravel from 'laravel-vite-plugin';\nimport vue from '@vitejs/plugin-vue';"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "vue"
+      },
+      "replace": "vite.config.js",
+      "skipIfContains": "vue({",
+      "find": "plugins: [",
+      "with": "$&\n        vue({ template: { transformAssetUrls: { base: null, includeAbsolute: false } } }),"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "replace": "vite.config.js",
+      "skipIfContains": "@vitejs/plugin-react",
+      "find": "import laravel from 'laravel-vite-plugin';",
+      "with": "import laravel from 'laravel-vite-plugin';\nimport react from '@vitejs/plugin-react';"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "replace": "vite.config.js",
+      "skipIfContains": "react(),",
+      "find": "plugins: [",
+      "with": "$&\n        react(),"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "replace": "vite.config.js",
+      "find": "resources/js/app.js'",
+      "with": "resources/js/app.jsx'"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "remove": "resources/js/app.js"
+    },
+    {
+      "label": "Applying BoilerCraft Inertia pages",
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "copy": "overlays/inertia-common"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "vue"
+      },
+      "copy": "overlays/inertia-vue"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": "react"
+      },
+      "copy": "overlays/inertia-react"
+    },
+    {
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "append": "routes/web.php",
+      "from": "snippets/web-routes-inertia.php"
+    },
+    {
+      "label": "Building frontend assets",
+      "when": {
+        "auth": false,
+        "frontend": [
+          "vue",
+          "react"
+        ]
+      },
+      "optional": true,
+      "run": [
+        "npm",
+        "run",
+        "build"
+      ]
+    }
+  ],
+  "vars": [
+    {
+      "name": "VITE_TAGS",
+      "when": {
+        "frontend": "vue"
+      },
+      "value": "@vite(['resources/css/app.css', 'resources/js/app.js'])"
+    },
+    {
+      "name": "VITE_TAGS",
+      "when": {
+        "frontend": "react"
+      },
+      "value": "@viteReactRefresh\n    @vite(['resources/css/app.css', 'resources/js/app.jsx'])"
+    },
+    {
+      "name": "VITE_PLUGIN_VUE",
+      "when": {
+        "version": "<11"
+      },
+      "value": "@vitejs/plugin-vue@^4"
+    },
+    {
+      "name": "VITE_PLUGIN_VUE",
+      "when": {
+        "version": ">=11"
+      },
+      "value": "@vitejs/plugin-vue"
+    },
+    {
+      "name": "VITE_PLUGIN_REACT",
+      "when": {
+        "version": "<11"
+      },
+      "value": "@vitejs/plugin-react@^4"
+    },
+    {
+      "name": "VITE_PLUGIN_REACT",
+      "when": {
+        "version": ">=11"
+      },
+      "value": "@vitejs/plugin-react"
+    }
+  ]
+}

package/stacks/nextjs/overlays/auth/src/lib/auth.js

@@ -0,0 +1,36 @@
+import jwt from 'jsonwebtoken';
+import bcrypt from 'bcryptjs';
+
+// In-memory user store so the auth flow works out of the box.
+// Replace with your database model (see src/lib/db.js).
+const users = globalThis.__bcUsers || (globalThis.__bcUsers = []);
+
+function secret() {
+  if (!process.env.JWT_SECRET) throw new Error('JWT_SECRET is not set (.env.local)');
+  return process.env.JWT_SECRET;
+}
+
+export function signToken(user) {
+  return jwt.sign({ id: user.id, name: user.name, email: user.email, role: user.role }, secret(), { expiresIn: '7d' });
+}
+
+export function verifyToken(token) {
+  return jwt.verify(token, secret());
+}
+
+export async function createUser({ name, email, password, role = 'user' }) {
+  if (users.some(u => u.email === email)) return null;
+  const user = { id: users.length + 1, name, email, role, password: await bcrypt.hash(password, 10) };
+  users.push(user);
+  return user;
+}
+
+export async function findUserByCredentials(email, password) {
+  const user = users.find(u => u.email === email);
+  if (!user || !(await bcrypt.compare(password, user.password))) return null;
+  return user;
+}
+
+export function publicUser({ password, ...rest }) {
+  return rest;
+}

package/stacks/nextjs/overlays/auth-app/src/app/api/auth/login/route.js

@@ -0,0 +1,11 @@
+import { NextResponse } from 'next/server';
+import { findUserByCredentials, signToken, publicUser } from '@/lib/auth';
+
+export async function POST(request) {
+  const { email, password } = await request.json();
+  const user = await findUserByCredentials(email, password);
+  if (!user) {
+    return NextResponse.json({ success: false, error: 'Invalid credentials.' }, { status: 401 });
+  }
+  return NextResponse.json({ success: true, token: signToken(user), user: publicUser(user) });
+}

package/stacks/nextjs/overlays/auth-app/src/app/api/auth/register/route.js

@@ -0,0 +1,14 @@
+import { NextResponse } from 'next/server';
+import { createUser, signToken, publicUser } from '@/lib/auth';
+
+export async function POST(request) {
+  const { name, email, password } = await request.json();
+  if (!name || !email || !password) {
+    return NextResponse.json({ success: false, error: 'Name, email and password are required.' }, { status: 400 });
+  }
+  const user = await createUser({ name, email, password });
+  if (!user) {
+    return NextResponse.json({ success: false, error: 'User already exists.' }, { status: 409 });
+  }
+  return NextResponse.json({ success: true, token: signToken(user), user: publicUser(user) }, { status: 201 });
+}

package/stacks/nextjs/overlays/auth-pages/src/pages/api/auth/login.js

@@ -0,0 +1,14 @@
+import { findUserByCredentials, signToken, publicUser } from '@/lib/auth';
+
+export default async function handler(req, res) {
+  if (req.method !== 'POST') {
+    res.setHeader('Allow', 'POST');
+    return res.status(405).json({ success: false, error: 'Method not allowed' });
+  }
+  const { email, password } = req.body || {};
+  const user = await findUserByCredentials(email, password);
+  if (!user) {
+    return res.status(401).json({ success: false, error: 'Invalid credentials.' });
+  }
+  return res.status(200).json({ success: true, token: signToken(user), user: publicUser(user) });
+}

package/stacks/nextjs/overlays/auth-pages/src/pages/api/auth/register.js

@@ -0,0 +1,17 @@
+import { createUser, signToken, publicUser } from '@/lib/auth';
+
+export default async function handler(req, res) {
+  if (req.method !== 'POST') {
+    res.setHeader('Allow', 'POST');
+    return res.status(405).json({ success: false, error: 'Method not allowed' });
+  }
+  const { name, email, password } = req.body || {};
+  if (!name || !email || !password) {
+    return res.status(400).json({ success: false, error: 'Name, email and password are required.' });
+  }
+  const user = await createUser({ name, email, password });
+  if (!user) {
+    return res.status(409).json({ success: false, error: 'User already exists.' });
+  }
+  return res.status(201).json({ success: true, token: signToken(user), user: publicUser(user) });
+}

package/stacks/nextjs/overlays/common/.env.example

@@ -0,0 +1,3 @@
+APP_NAME={{APP_TITLE_JS}}
+JWT_SECRET=change-me
+{{DB_ENV_EXAMPLE}}

package/stacks/nextjs/overlays/common/.env.local

@@ -0,0 +1,3 @@
+APP_NAME={{APP_TITLE_JS}}
+JWT_SECRET={{RANDOM_SECRET}}
+{{DB_ENV}}

package/stacks/nextjs/overlays/db/mongodb/src/lib/db.js

@@ -0,0 +1,12 @@
+import mongoose from 'mongoose';
+
+// Cached across hot reloads in development.
+const cached = globalThis.__bcMongoose || (globalThis.__bcMongoose = { conn: null, promise: null });
+
+export async function connectDB() {
+  if (cached.conn) return cached.conn;
+  const uri = process.env.MONGODB_URI || 'mongodb://127.0.0.1:27017/{{DB_NAME}}';
+  cached.promise ||= mongoose.connect(uri);
+  cached.conn = await cached.promise;
+  return cached.conn;
+}

package/stacks/nextjs/overlays/db/mssql/src/lib/db.js

@@ -0,0 +1,17 @@
+import sql from '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 }
+};
+
+export function connectDB() {
+  globalThis.__bcMssql ||= sql.connect(config);
+  return globalThis.__bcMssql;
+}
+
+export { sql };

package/stacks/nextjs/overlays/db/mysql/src/lib/db.js

@@ -0,0 +1,13 @@
+import mysql from 'mysql2/promise';
+
+const pool = globalThis.__bcMysql || (globalThis.__bcMysql = 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)
+}));
+
+export function connectDB() {
+  return pool;
+}

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

@@ -0,0 +1,10 @@
+import { NextResponse } from 'next/server';
+
+export async function GET() {
+  return NextResponse.json({
+    status: 'online',
+    stack: 'Next.js {{VERSION}} App Router',
+    database: '{{DB_TYPE}}',
+    appName: {{APP_TITLE_JS}}
+  });
+}

package/stacks/nextjs/overlays/router-app/src/app/layout.js

@@ -0,0 +1,16 @@
+import './globals.css';
+import '../styles/theme.css';
+import '../styles/vendor.js';
+
+export const metadata = {
+  title: {{APP_TITLE_JS}},
+  description: {{APP_DESC_JS}}
+};
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en" data-theme="{{COLOR_MODE}}">
+      <body>{children}</body>
+    </html>
+  );
+}

package/stacks/nextjs/overlays/router-app/src/app/page.js

@@ -0,0 +1,19 @@
+export default function Home() {
+  return (
+    <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}} (App 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/overlays/router-pages/src/pages/_app.js

@@ -0,0 +1,7 @@
+import '@/styles/globals.css';
+import '@/styles/theme.css';
+{{PAGES_VENDOR_CSS}}
+
+export default function App({ Component, pageProps }) {
+  return <Component {...pageProps} />;
+}