boilercraft 1.0.0

package/docs/stacks/nextjs.md

@@ -0,0 +1,58 @@
+# 🚀 Next.js (App Router) Full Documentation & Maintenance Guide
+
+## 📌 Overview
+Modern **Next.js 14/15 App Router** enterprise boilerplate supporting React Server Components (RSC), Server Actions, dynamic database connections (**MongoDB**, **MSSQL**, or **MySQL**), and theming.
+
+---
+
+## 📂 Architecture & Directory Tree
+```text
+├── src/
+│   ├── app/
+│   │   ├── api/
+│   │   │   ├── health/route.js    # System health check route handler
+│   │   │   └── auth/login/route.js# Next.js authentication handler
+│   │   ├── layout.jsx             # Root layout with HTML data-theme injection
+│   │   └── page.jsx               # Landing page with interactive components
+│   ├── lib/
+│   │   └── db.js                  # Database connection pool / client
+│   └── styles/
+│       └── theme.css              # Curated CSS Variable palette
+├── package.json
+└── .env
+```
+
+---
+
+## ⚡ Quick Start & Running
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Start development server with hot-reload:
+```bash
+npm run dev
+```
+
+3. Build and run production server:
+```bash
+npm run build
+npm start
+```
+
+---
+
+## 🗄️ Database Usage in Server Components & Routes
+
+### Example: Querying in Route Handler (`src/app/api/users/route.js`):
+```javascript
+import { NextResponse } from 'next/server';
+import { connectDB } from '@/lib/db';
+
+export async function GET() {
+  const db = await connectDB();
+  // Execute database queries here
+  return NextResponse.json({ success: true });
+}
+```

package/docs/stacks/node-express.md

@@ -0,0 +1,58 @@
+# ⚡ Node.js + Express Full Documentation & Maintenance Guide
+
+## 📌 Overview
+Production-ready **Node.js Express Clean Architecture** boilerplate featuring modular controllers, routes, global error handling middlewares, **JWT Authentication**, and database drivers (**MongoDB Mongoose**, **MySQL2**, or **MSSQL**).
+
+---
+
+## 📂 Architecture & Directory Tree
+```text
+├── src/
+│   ├── controllers/
+│   │   └── authController.js     # User registration, login, and profiles
+│   ├── middlewares/
+│   │   ├── auth.js               # JWT verification & role authorization guard
+│   │   └── errorHandler.js       # Centralized error handler
+│   ├── routes/
+│   │   ├── authRoutes.js         # Authentication endpoints
+│   │   └── api.js                # Resource endpoints
+│   ├── db.js                     # Unified database connection connector
+│   └── server.js                 # Express server configuration
+├── public/                       # Static assets & theme files
+├── package.json
+└── .env
+```
+
+---
+
+## ⚡ Quick Start & Running
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Start development server (with hot auto-reload):
+```bash
+npm run dev
+```
+
+---
+
+## 🔐 Route Authentication & Role Guards
+Protecting endpoints in `src/routes/api.js`:
+
+```javascript
+const express = require('express');
+const router = express.Router();
+const { auth, role } = require('../middlewares/auth');
+
+// Protected for any authenticated user
+router.get('/profile', auth, (req, res) => {
+  res.json({ user: req.user });
+});
+
+// Protected for 'admin' role only
+router.delete('/user/:id', auth, role('admin'), (req, res) => {
+  res.json({ message: 'User deleted' });
+});
+```

package/docs/stacks/raw-php.md

@@ -0,0 +1,130 @@
+# 🐘 Raw PHP (MVC) Full Documentation & Maintenance Guide
+
+## 📌 Overview
+This boilerplate provides a production-grade, zero-dependency MVC framework in pure PHP, featuring a **Singleton Multi-Driver PDO**, **Fluent QueryBuilder**, **Session Authentication with Role Guards**, and **Native .env parsing**.
+
+---
+
+## 📂 Architecture & Directory Tree
+```text
+├── app/
+│   ├── Controllers/
+│   │   ├── HomeController.php    # Landing page, health check, AJAX demo
+│   │   └── AuthController.php    # Register, Login, Session handling
+│   ├── Models/
+│   │   └── User.php              # User model leveraging QueryBuilder & Auto-Schema
+│   └── Views/
+│       ├── home.php              # Dynamic Landing view (AJAX + jQuery demo)
+│       ├── dashboard.php         # Protected Dashboard with role badges
+│       ├── 404.php               # Error page
+│       └── auth/
+│           ├── login.php         # AJAX login interface
+│           └── register.php      # AJAX register interface
+├── config/
+│   ├── Database.php              # Multi-driver PDO (MySQL, MSSQL, SQLite, Postgres)
+│   ├── QueryBuilder.php          # Fluent SQL Query Builder
+│   ├── Auth.php                  # Session authentication & Role manager
+│   ├── Middleware.php            # Route guards (auth, guest, role)
+│   ├── Router.php                # Lightweight custom URL dispatcher
+│   └── Env.php                   # Native .env parser (No composer needed)
+├── public/                       # Web Document Root
+│   ├── index.php                 # Front Controller & Route dispatcher
+│   ├── css/theme.css             # Theme variable stylesheet
+│   └── js/theme.js               # Theme switching script
+└── .env                          # Local Environment configuration
+```
+
+---
+
+## ⚡ Quick Start & Running
+1. Open your terminal in the generated project root.
+2. Run the built-in PHP development server:
+```bash
+php -S localhost:8000 -t public
+```
+3. Open your browser at: `http://localhost:8000`
+
+---
+
+## 🔐 Authentication & Route Guards
+Protecting routes in `public/index.php`:
+
+```php
+use App\Config\Middleware;
+
+// 1. Authenticated Users Only:
+$router->get('/dashboard', function() {
+    Middleware::auth(); // Redirects unauthenticated visitors to /login
+    require __DIR__ . '/../app/Views/dashboard.php';
+});
+
+// 2. Specific Role Guard (e.g. 'admin'):
+$router->get('/admin', function() {
+    Middleware::role('admin'); // Returns 403 Forbidden if not admin
+    require __DIR__ . '/../app/Views/admin.php';
+});
+
+// 3. Guest Only (Redirects logged-in users away from login/register):
+$router->get('/login', function() {
+    Middleware::guest();
+    (new AuthController())->showLogin();
+});
+```
+
+---
+
+## 🗄️ QueryBuilder Usage Guide
+
+### Fetch Records:
+```php
+use App\Config\QueryBuilder;
+
+// Select specific columns with conditions & ordering
+$users = QueryBuilder::table('users')
+    ->select(['id', 'name', 'email'])
+    ->where('role', 'user')
+    ->orderBy('id', 'DESC')
+    ->limit(10)
+    ->get();
+
+// Find single record
+$user = QueryBuilder::table('users')->where('id', 1)->first();
+```
+
+### Insert & Update:
+```php
+// Insert
+QueryBuilder::table('users')->insert([
+    'name' => 'John Doe',
+    'email' => 'john@example.com',
+    'role' => 'user'
+]);
+
+// Update
+QueryBuilder::table('users')
+    ->where('id', 1)
+    ->update(['name' => 'Updated Name']);
+```
+
+---
+
+## 🗄️ Database Configuration (.env)
+Edit your `.env` file to switch databases seamlessly:
+
+```ini
+# MySQL
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_NAME=my_app_db
+DB_USER=root
+DB_PASS=
+
+# OR Microsoft SQL Server (MSSQL)
+# DB_CONNECTION=mssql
+# DB_HOST=127.0.0.1
+# DB_PORT=1433
+# DB_NAME=my_app_db
+# DB_USER=sa
+# DB_PASS=YourStrong@Password
+```

package/main.js

@@ -0,0 +1,82 @@
+const { app, BrowserWindow, dialog, ipcMain } = require('electron');
+const path = require('path');
+const { autoUpdater } = require('electron-updater');
+const { startServer } = require('./server');
+
+let mainWindow;
+
+autoUpdater.autoDownload = true;
+autoUpdater.autoInstallOnAppQuit = true;
+
+function setupAutoUpdater() {
+  autoUpdater.on('update-downloaded', (info) => {
+    dialog.showMessageBox({
+      type: 'info',
+      title: 'Update Ready — BoilerCraft Studio',
+      message: `A brand new version (${info.version}) of BoilerCraft Studio has been downloaded automatically.`,
+      buttons: ['Restart Now to Update', 'Later']
+    }).then((buttonIndex) => {
+      if (buttonIndex.response === 0) {
+        autoUpdater.quitAndInstall();
+      }
+    });
+  });
+}
+
+function createWindow(port) {
+  mainWindow = new BrowserWindow({
+    width: 1380,
+    height: 920,
+    minWidth: 1080,
+    minHeight: 720,
+    title: 'BoilerCraft Studio',
+    icon: path.join(__dirname, 'assets', 'icon.png'),
+    backgroundColor: '#ffffff',
+    autoHideMenuBar: true,
+    show: false,
+    webPreferences: {
+      nodeIntegration: true,
+      contextIsolation: false
+    }
+  });
+
+  mainWindow.loadURL(`http://localhost:${port}`);
+
+  mainWindow.once('ready-to-show', () => {
+    mainWindow.show();
+  });
+
+  mainWindow.on('closed', function () {
+    mainWindow = null;
+  });
+}
+
+// IPC handler to open native Windows Folder Picker dialog
+ipcMain.handle('select-directory', async () => {
+  const result = await dialog.showOpenDialog(mainWindow, {
+    properties: ['openDirectory', 'createDirectory'],
+    title: 'Select Destination Folder for Your Project'
+  });
+  if (result.canceled || !result.filePaths || result.filePaths.length === 0) {
+    return null;
+  }
+  return result.filePaths[0];
+});
+
+app.whenReady().then(() => {
+  startServer((port) => {
+    createWindow(port);
+    if (app.isPackaged) {
+      setupAutoUpdater();
+      autoUpdater.checkForUpdatesAndNotify();
+    }
+  });
+
+  app.on('activate', function () {
+    if (BrowserWindow.getAllWindows().length === 0) createWindow(4800);
+  });
+});
+
+app.on('window-all-closed', function () {
+  if (process.platform !== 'darwin') app.quit();
+});

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "boilercraft",
+  "version": "1.0.0",
+  "description": "Create Laravel, Next.js, Express and .NET projects with the official tooling — any version, auth, themes. Run: npx boilercraft",
+  "main": "main.js",
+  "scripts": {
+    "start": "node server.js",
+    "desktop": "electron .",
+    "dev": "node server.js",
+    "build:exe": "electron-builder --win portable",
+    "cli": "node bin/boilercraft.js"
+  },
+  "build": {
+    "appId": "com.argrabbi.boilercraft",
+    "productName": "BoilerCraft Studio",
+    "publish": {
+      "provider": "github",
+      "owner": "itrabbi24",
+      "repo": "BoilerCraft"
+    },
+    "win": {
+      "icon": "assets/icon.png",
+      "target": [
+        "nsis",
+        "portable"
+      ],
+      "requestedExecutionLevel": "asInvoker"
+    },
+    "directories": {
+      "output": "dist"
+    }
+  },
+  "keywords": [
+    "boilerplate",
+    "scaffolding",
+    "nextjs",
+    "laravel",
+    "nodejs",
+    "dotnet",
+    "generator",
+    "cli",
+    "scaffold",
+    "create-app",
+    "npx"
+  ],
+  "author": "ARG RABBI",
+  "license": "MIT",
+  "type": "commonjs",
+  "dependencies": {
+    "archiver": "^8.0.0",
+    "axios": "^1.20.0",
+    "cors": "^2.8.6",
+    "ejs": "^6.0.1",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "concurrently": "^10.0.5",
+    "electron": "^44.4.5",
+    "electron-builder": "^26.15.3",
+    "wait-on": "^9.1.0",
+    "electron-updater": "^6.8.9"
+  },
+  "bin": {
+    "boilercraft": "bin/boilercraft.js"
+  },
+  "engines": {
+    "node": ">=18.3"
+  },
+  "files": [
+    "bin/",
+    "cli/",
+    "services/",
+    "stacks/",
+    "templates/",
+    "public/",
+    "docs/",
+    "server.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itrabbi24/BoilerCraft.git"
+  },
+  "homepage": "https://github.com/itrabbi24/BoilerCraft#readme"
+}