boilercraft 1.0.0

package/stacks/dotnet-core/stack.json

@@ -0,0 +1,426 @@
+{
+  "id": "dotnet-core",
+  "name": ".NET (ASP.NET Core Web API)",
+  "aliases": [
+    "dotnet",
+    "dotnet-bootstrap-mssql"
+  ],
+  "defaultPort": 5000,
+  "databases": [
+    "mssql",
+    "mysql"
+  ],
+  "stylings": [
+    "tailwind",
+    "bootstrap",
+    "vanilla"
+  ],
+  "options": [
+    {
+      "id": "template",
+      "label": "Project type",
+      "default": "mvc",
+      "choices": [
+        {
+          "value": "mvc",
+          "label": "MVC (Model · View · Controller)",
+          "hint": "server-rendered pages · Razor views"
+        },
+        {
+          "value": "api",
+          "label": "Web API",
+          "hint": "JSON endpoints · Swagger · for SPA / mobile"
+        }
+      ]
+    }
+  ],
+  "nextSteps": [
+    "dotnet run --urls http://localhost:{{PORT}}"
+  ],
+  "versions": {
+    "source": "dotnet",
+    "minMajor": 8,
+    "testedUpTo": 10,
+    "lts": [
+      8,
+      10
+    ],
+    "offline": [
+      10,
+      9,
+      8
+    ]
+  },
+  "requires": [
+    {
+      "cmd": "dotnet",
+      "args": [
+        "--list-sdks"
+      ],
+      "name": ".NET SDK",
+      "install": "https://dotnet.microsoft.com/download",
+      "minMajor": {
+        "pattern": "^(\\d+)\\."
+      }
+    }
+  ],
+  "vars": [
+    {
+      "name": "SWASHBUCKLE_VERSION",
+      "when": {
+        "version": "<10"
+      },
+      "value": "9.*"
+    },
+    {
+      "name": "SWASHBUCKLE_VERSION",
+      "when": {
+        "version": ">=10"
+      },
+      "value": "10.*"
+    },
+    {
+      "name": "DB_USE",
+      "when": {
+        "database": "mssql"
+      },
+      "value": "options.UseSqlServer(connectionString)"
+    },
+    {
+      "name": "DB_USE",
+      "when": {
+        "database": "mysql"
+      },
+      "value": "options.UseMySql(connectionString, new MySqlServerVersion(new Version(8, 0, 36)))"
+    },
+    {
+      "name": "CONNECTION_STRING",
+      "when": {
+        "database": "mssql"
+      },
+      "value": "Server=localhost,1433;Database={{DB_NAME}};User Id=sa;Password=change-me;TrustServerCertificate=True;"
+    },
+    {
+      "name": "CONNECTION_STRING",
+      "when": {
+        "database": "mysql"
+      },
+      "value": "Server=localhost;Port=3306;Database={{DB_NAME}};Uid=root;Pwd=;"
+    },
+    {
+      "name": "AUTH_USINGS",
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "value": "using System.Text;\nusing Microsoft.AspNetCore.Authentication.JwtBearer;\nusing Microsoft.IdentityModel.Tokens;"
+    },
+    {
+      "name": "AUTH_SERVICES",
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "value": "var jwtKey = builder.Configuration[\"Jwt:Key\"] ?? throw new InvalidOperationException(\"Jwt:Key is not configured\");\nbuilder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)\n    .AddJwtBearer(options =>\n    {\n        options.TokenValidationParameters = new TokenValidationParameters\n        {\n            ValidateIssuer = false,\n            ValidateAudience = false,\n            ValidateIssuerSigningKey = true,\n            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(jwtKey))\n        };\n    });"
+    },
+    {
+      "name": "AUTH_MIDDLEWARE",
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "value": "app.UseAuthentication();"
+    },
+    {
+      "name": "DBCONTEXT_EXTRA",
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "value": "public DbSet<AppUser> Users { get; set; }"
+    },
+    {
+      "name": "PRODUCTS_AUTHORIZE",
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "value": "[Microsoft.AspNetCore.Authorization.Authorize]"
+    },
+    {
+      "name": "MVC_USINGS",
+      "when": {
+        "template": "mvc"
+      },
+      "value": "using Microsoft.EntityFrameworkCore;\nusing {{NAMESPACE}}.Data;\n"
+    },
+    {
+      "name": "MVC_AUTH_USINGS",
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "value": "using Microsoft.AspNetCore.Authentication.Cookies;\n"
+    },
+    {
+      "name": "MVC_AUTH_SERVICES",
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "value": "\nbuilder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)\n    .AddCookie(options =>\n    {\n        options.LoginPath = \"/Account/Login\";\n        options.LogoutPath = \"/Account/Logout\";\n    });"
+    }
+  ],
+  "steps": [
+    {
+      "label": "Running official dotnet new webapi (net{{VERSION}}.0)",
+      "cwd": "parent",
+      "run": [
+        "dotnet",
+        "new",
+        "webapi",
+        "-n",
+        "{{PROJECT_NAME}}",
+        "-o",
+        "{{PROJECT_NAME}}",
+        "--framework",
+        "net{{VERSION}}.0"
+      ],
+      "when": {
+        "template": "api"
+      }
+    },
+    {
+      "label": "Running official dotnet new mvc (net{{VERSION}}.0)",
+      "when": {
+        "template": "mvc"
+      },
+      "cwd": "parent",
+      "run": [
+        "dotnet",
+        "new",
+        "mvc",
+        "-n",
+        "{{PROJECT_NAME}}",
+        "-o",
+        "{{PROJECT_NAME}}",
+        "--framework",
+        "net{{VERSION}}.0"
+      ]
+    },
+    {
+      "label": "Creating Visual Studio solution",
+      "run": [
+        "dotnet",
+        "new",
+        "sln",
+        "-n",
+        "{{PROJECT_NAME}}"
+      ]
+    },
+    {
+      "run": [
+        "dotnet",
+        "sln",
+        "add",
+        "{{PROJECT_NAME}}.csproj"
+      ]
+    },
+    {
+      "label": "Adding NuGet packages for .NET {{VERSION}}",
+      "insertBefore": "{{PROJECT_NAME}}.csproj",
+      "marker": "</Project>",
+      "from": "snippets/packages-ef.xml"
+    },
+    {
+      "insertBefore": "{{PROJECT_NAME}}.csproj",
+      "marker": "</Project>",
+      "from": "snippets/packages-swagger.xml",
+      "when": {
+        "template": "api"
+      }
+    },
+    {
+      "when": {
+        "database": "mssql"
+      },
+      "insertBefore": "{{PROJECT_NAME}}.csproj",
+      "marker": "</Project>",
+      "from": "snippets/packages-mssql.xml"
+    },
+    {
+      "when": {
+        "database": "mysql"
+      },
+      "insertBefore": "{{PROJECT_NAME}}.csproj",
+      "marker": "</Project>",
+      "from": "snippets/packages-mysql.xml"
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "insertBefore": "{{PROJECT_NAME}}.csproj",
+      "marker": "</Project>",
+      "from": "snippets/packages-auth.xml"
+    },
+    {
+      "label": "Applying BoilerCraft overlay",
+      "copy": "overlays/common"
+    },
+    {
+      "when": {
+        "template": "api"
+      },
+      "copy": "overlays/api"
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "copy": "overlays/api-auth"
+    },
+    {
+      "write": "wwwroot/theme.css",
+      "content": "{{THEME_CSS}}",
+      "when": {
+        "template": "api"
+      }
+    },
+    {
+      "write": "wwwroot/theme.js",
+      "content": "{{THEME_JS}}",
+      "when": {
+        "template": "api"
+      }
+    },
+    {
+      "json": "appsettings.json",
+      "merge": {
+        "ConnectionStrings": {
+          "DefaultConnection": "{{CONNECTION_STRING}}"
+        }
+      }
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "api"
+      },
+      "json": "appsettings.Development.json",
+      "merge": {
+        "Jwt": {
+          "Key": "{{RANDOM_SECRET}}"
+        }
+      }
+    },
+    {
+      "label": "Wiring MVC: database, views and navigation",
+      "when": {
+        "template": "mvc"
+      },
+      "copy": "overlays/mvc"
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "copy": "overlays/mvc-auth"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "write": "wwwroot/css/boilercraft-theme.css",
+      "content": "{{THEME_CSS}}"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "write": "wwwroot/js/boilercraft-theme.js",
+      "content": "{{THEME_JS}}"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "prepend": "Program.cs",
+      "content": "{{MVC_USINGS}}{{MVC_AUTH_USINGS}}\n"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "replace": "Program.cs",
+      "skipIfContains": "ApplicationDbContext",
+      "find": "builder.Services.AddControllersWithViews();",
+      "with": "$&\n\n// Database: {{DATABASE}} (Entity Framework Core)\nvar connectionString = builder.Configuration.GetConnectionString(\"DefaultConnection\")\n    ?? throw new InvalidOperationException(\"ConnectionStrings:DefaultConnection is not configured\");\nbuilder.Services.AddDbContext<ApplicationDbContext>(options => {{DB_USE}});{{MVC_AUTH_SERVICES}}"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "replace": "Program.cs",
+      "skipIfContains": "EnsureCreated",
+      "find": "var app = builder.Build();",
+      "with": "$&\n\n// Development convenience: create the database/tables if they do not exist yet.\n// For production, switch to EF Core migrations (dotnet ef migrations add Initial).\nif (app.Environment.IsDevelopment())\n{\n    using var scope = app.Services.CreateScope();\n    try\n    {\n        scope.ServiceProvider.GetRequiredService<ApplicationDbContext>().Database.EnsureCreated();\n    }\n    catch (Exception ex)\n    {\n        app.Logger.LogWarning(\"Could not reach the database ({Message}). Check ConnectionStrings:DefaultConnection.\", ex.Message);\n    }\n}"
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "replace": "Program.cs",
+      "skipIfContains": "app.UseAuthentication();",
+      "find": "app.UseAuthorization();",
+      "with": "app.UseAuthentication();\n$&"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "replace": "Views/Shared/_Layout.cshtml",
+      "find": "<html lang=\"en\">",
+      "with": "<html lang=\"en\" data-theme=\"{{COLOR_MODE}}\">"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "insertBefore": "Views/Shared/_Layout.cshtml",
+      "marker": "</head>",
+      "content": "    <link rel=\"stylesheet\" href=\"~/css/boilercraft-theme.css\" asp-append-version=\"true\" />\n"
+    },
+    {
+      "when": {
+        "template": "mvc"
+      },
+      "replace": "Views/Shared/_Layout.cshtml",
+      "skipIfContains": "asp-controller=\"Products\"",
+      "findRegex": "asp-action=\"Privacy\">Privacy</a>\\s*</li>",
+      "with": "$&\n                        <li class=\"nav-item\">\n                            <a class=\"nav-link text-dark\" asp-area=\"\" asp-controller=\"Products\" asp-action=\"Index\">Products</a>\n                        </li>"
+    },
+    {
+      "when": {
+        "auth": true,
+        "template": "mvc"
+      },
+      "replace": "Views/Shared/_Layout.cshtml",
+      "skipIfContains": "_AuthNav",
+      "find": "</ul>",
+      "with": "$&\n                    <partial name=\"_AuthNav\" />"
+    },
+    {
+      "label": "Restoring packages",
+      "optional": true,
+      "run": [
+        "dotnet",
+        "restore"
+      ]
+    }
+  ]
+}

package/stacks/laravel/overlays/auth/app/Http/Controllers/Api/AuthController.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Validation\ValidationException;
+
+class AuthController extends Controller
+{
+    public function register(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:255'],
+            'email' => ['required', 'string', 'email', 'max:255', 'unique:users'],
+            'password' => ['required', 'string', 'min:8', 'confirmed'],
+        ]);
+
+        $user = User::create([
+            'name' => $validated['name'],
+            'email' => $validated['email'],
+            'password' => Hash::make($validated['password']),
+        ]);
+
+        return response()->json([
+            'success' => true,
+            'token' => $user->createToken('api')->plainTextToken,
+            'user' => $user,
+        ], 201);
+    }
+
+    public function login(Request $request)
+    {
+        $credentials = $request->validate([
+            'email' => ['required', 'email'],
+            'password' => ['required'],
+        ]);
+
+        $user = User::where('email', $credentials['email'])->first();
+
+        if (! $user || ! Hash::check($credentials['password'], $user->password)) {
+            throw ValidationException::withMessages([
+                'email' => ['The provided credentials do not match our records.'],
+            ]);
+        }
+
+        return response()->json([
+            'success' => true,
+            'token' => $user->createToken('api')->plainTextToken,
+            'user' => $user,
+        ]);
+    }
+
+    public function me(Request $request)
+    {
+        return response()->json(['success' => true, 'user' => $request->user()]);
+    }
+
+    public function logout(Request $request)
+    {
+        $request->user()->currentAccessToken()->delete();
+
+        return response()->json(['success' => true, 'message' => 'Logged out successfully.']);
+    }
+}

package/stacks/laravel/overlays/common/app/Http/Controllers/BoilerCraftController.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Http\Controllers;
+
+class BoilerCraftController extends Controller
+{
+    public function index()
+    {
+        return view('boilercraft', [
+            'laravelVersion' => app()->version(),
+            'database' => config('database.default'),
+        ]);
+    }
+}

package/stacks/laravel/overlays/common/resources/views/boilercraft.blade.php

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" data-theme="{{COLOR_MODE}}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{ config('app.name') }}</title>
+    <link rel="stylesheet" href="{{ asset('css/boilercraft-theme.css') }}">
+    @verbatim
+    {{STYLESHEET_LINK}}
+    @endverbatim
+</head>
+<body class="p-6">
+    <div style="max-width: 900px; margin: 2rem auto; text-align: center;">
+        @verbatim
+        {{LOGO_HTML}}
+        @endverbatim
+        <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>Framework:</strong> Laravel {{ $laravelVersion }}</li>
+                <li><strong>Database connection:</strong> {{ $database }}</li>
+                <li><strong>Styling:</strong> {{STYLING}}</li>
+            </ul>
+            <hr style="border: none; border-top: 1px solid var(--color-border); margin: 1.5rem 0;" />
+            <h4>Components:</h4>
+            @verbatim
+            {{UI_COMPONENTS}}
+            @endverbatim
+        </div>
+    </div>
+    <script src="{{ asset('js/boilercraft-theme.js') }}"></script>
+</body>
+</html>

package/stacks/laravel/overlays/inertia-common/resources/views/app.blade.php

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="{{ str_replace('_', '-', app()->getLocale()) }}" data-theme="{{COLOR_MODE}}">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title inertia>{{ config('app.name') }}</title>
+    <link rel="stylesheet" href="{{ asset('css/boilercraft-theme.css') }}">
+    {{VITE_TAGS}}
+    @inertiaHead
+</head>
+<body>
+    @inertia
+    <script src="{{ asset('js/boilercraft-theme.js') }}"></script>
+</body>
+</html>

package/stacks/laravel/overlays/inertia-react/resources/js/Pages/Welcome.jsx

@@ -0,0 +1,18 @@
+export default function Welcome({ laravelVersion, database }) {
+    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> Laravel {laravelVersion} + React (Inertia)</li>
+                    <li><strong>Database connection:</strong> {database}</li>
+                    <li><strong>Styling:</strong> {{STYLING}}</li>
+                    <li><strong>Theme:</strong> {{THEME}}</li>
+                </ul>
+            </div>
+        </div>
+    );
+}

package/stacks/laravel/overlays/inertia-react/resources/js/app.jsx

@@ -0,0 +1,13 @@
+import './bootstrap';
+import { createInertiaApp } from '@inertiajs/react';
+import { createRoot } from 'react-dom/client';
+
+createInertiaApp({
+    resolve: (name) => {
+        const pages = import.meta.glob('./Pages/**/*.jsx', { eager: true });
+        return pages[`./Pages/${name}.jsx`];
+    },
+    setup({ el, App, props }) {
+        createRoot(el).render(<App {...props} />);
+    },
+});

package/stacks/laravel/overlays/inertia-vue/resources/js/Pages/Welcome.vue

@@ -0,0 +1,23 @@
+<script setup>
+defineProps({
+    laravelVersion: String,
+    database: String,
+});
+</script>
+
+<template>
+    <div style="max-width: 900px; margin: 3rem auto; padding: 1rem; text-align: center;">
+        <h1 style="font-size: 2.5rem; font-weight: 800;">{{APP_TITLE}}</h1>
+        <p style="color: var(--color-text-muted);">{{APP_DESC}}</p>
+
+        <div style="margin-top: 2rem; padding: 1.5rem; background: var(--color-surface); border-radius: 1rem; text-align: left; border: 1px solid var(--color-border);">
+            <h3>Configured Architecture:</h3>
+            <ul>
+                <li><strong>Framework:</strong> Laravel {{ laravelVersion }} + Vue 3 (Inertia)</li>
+                <li><strong>Database connection:</strong> {{ database }}</li>
+                <li><strong>Styling:</strong> {{STYLING}}</li>
+                <li><strong>Theme:</strong> {{THEME}}</li>
+            </ul>
+        </div>
+    </div>
+</template>

package/stacks/laravel/overlays/inertia-vue/resources/js/app.js

@@ -0,0 +1,13 @@
+import './bootstrap';
+import { createApp, h } from 'vue';
+import { createInertiaApp } from '@inertiajs/vue3';
+
+createInertiaApp({
+    resolve: (name) => {
+        const pages = import.meta.glob('./Pages/**/*.vue', { eager: true });
+        return pages[`./Pages/${name}.vue`];
+    },
+    setup({ el, App, props, plugin }) {
+        createApp({ render: () => h(App, props) }).use(plugin).mount(el);
+    },
+});

package/stacks/laravel/snippets/api-routes.php

@@ -0,0 +1,9 @@
+
+
+// BoilerCraft token authentication (Laravel Sanctum).
+Route::post('/auth/register', [\App\Http\Controllers\Api\AuthController::class, 'register']);
+Route::post('/auth/login', [\App\Http\Controllers\Api\AuthController::class, 'login']);
+Route::middleware('auth:sanctum')->group(function () {
+    Route::get('/auth/me', [\App\Http\Controllers\Api\AuthController::class, 'me']);
+    Route::post('/auth/logout', [\App\Http\Controllers\Api\AuthController::class, 'logout']);
+});

package/stacks/laravel/snippets/web-routes-inertia.php

@@ -0,0 +1,7 @@
+
+
+// BoilerCraft landing page (Inertia), registered last so it replaces the default welcome route.
+Route::get('/', fn () => \Inertia\Inertia::render('Welcome', [
+    'laravelVersion' => app()->version(),
+    'database' => config('database.default'),
+]))->name('home');

package/stacks/laravel/snippets/web-routes.php

@@ -0,0 +1,4 @@
+
+
+// BoilerCraft landing page (registered last, so it replaces the default welcome route).
+Route::get('/', [\App\Http\Controllers\BoilerCraftController::class, 'index'])->name('home');