boilercraft 1.0.0 → 1.1.0

package/README.md

@@ -27,8 +27,8 @@ npx boilercraft
 
 Most boilerplates are a frozen copy of someone's project. They go stale the day a new framework version ships. BoilerCraft works differently:
 
-- **Always the real thing.** The base project is created by the framework's own creator (`composer create-project`, `create-next-app`, `dotnet new`, `npm`), so it matches the version you pick exactly.
-- **Any version, including future ones.** Versions are fetched live from npm, Packagist and the .NET release index. A new release shows up in the menu without an update to BoilerCraft.
+- **Always the real thing.** The base project is created by the framework's own creator (`composer create-project`, `create-next-app`, `nest new`, `create-vite`, `django-admin`, `dotnet new`, `go mod init`), so it matches the version you pick exactly.
+- **Any version, including future ones.** Versions are fetched live from npm, Packagist, PyPI, the Go module proxy and the .NET release index. A new release shows up in the menu without an update to BoilerCraft.
 - **Ready to build on.** Auth, database wiring, a themed landing page and UI components are added on top, so you start with a working app instead of a blank one.
 - **One command, zero setup.** Everything happens inside `npx boilercraft`. Missing PHP, Composer or the .NET SDK? It offers to install them for you.
 
@@ -53,8 +53,13 @@ When it's done, pick **Start the dev server** or **Open in VS Code** from the sa
 | **Laravel** | 10 – 13 | Blade · Vue 3 (Inertia) · React (Inertia) | MySQL · SQL Server | Sanctum API tokens, or full Breeze UI (login, register, profile) for Vue/React |
 | **Next.js** | 14 – 16 | App Router · Pages Router | MongoDB · MySQL · SQL Server | JWT register/login API routes |
 | **.NET** | 8 – 10 | MVC (Model · View · Controller) · Web API | SQL Server · MySQL | MVC: cookie login/register pages · API: JWT + Swagger |
+| **NestJS** | 10 – 12 | — | PostgreSQL · MySQL · MongoDB · SQLite | — (add Prisma for the data layer) |
 | **Node.js + Express** | 4 – 5 | — | MySQL · MongoDB · SQL Server | JWT middleware with roles |
-| **Raw PHP (MVC)** | — | — | MySQL | Session auth |
+| **Vite** | 6 – 9 | React · Vue · Svelte, TypeScript or JavaScript | — (frontend) | — |
+| **Django** | 4 – 6 | — | SQLite · PostgreSQL | Built-in admin + auth |
+| **FastAPI** | 0.x | — | SQLite · PostgreSQL (SQLAlchemy) · none | — |
+| **Go + Gin** | 1.x | — | — | — |
+| **Raw PHP (MVC)** | 8 | — | MySQL · PostgreSQL · SQLite · SQL Server | Session auth |
 
 Every project also gets:
 - A **theme**: Slate Midnight, Cyber Emerald, Royal Indigo or Crimson Amber, in dark, light or both with a toggle.
@@ -63,6 +68,19 @@ Every project also gets:
 
 The version list above is just what's verified today. Newer releases appear automatically and are marked *preview support* until verified.
 
+### Extras
+
+Pick any of these with space in the **Extras** step, or pass `-e docker,ci`:
+
+| Extra | What you get | Available for |
+|---|---|---|
+| **Docker** | `Dockerfile`, `.dockerignore` and a `docker-compose.yml` that also starts your database (MySQL, PostgreSQL, MongoDB or SQL Server) | every framework |
+| **GitHub Actions CI** | `.github/workflows/ci.yml` that installs, lints, builds and tests on every push and pull request | every framework |
+| **ESLint + Prettier** | configs plus `npm run lint` and `npm run format` | Next.js · NestJS · Express · Vite |
+| **Prisma ORM** | `prisma/schema.prisma`, the client, a `DATABASE_URL` for your database, `npm run db:migrate` | Next.js · NestJS · Express |
+
+After the files are in place, BoilerCraft runs `git init` and makes an **initial commit**, so the project starts with a clean history (turn it off with `--no-git`).
+
 ## Missing a toolchain?
 
 BoilerCraft checks what's installed and offers to set up the rest. You can also do it any time from **Check & install tools** in the menu.
@@ -72,10 +90,52 @@ BoilerCraft checks what's installed and offers to set up the rest. You can also
 | .NET SDK | .NET | Microsoft's official `dotnet-install` script, exact version, user folder, **no admin rights** |
 | Composer | Laravel | Official installer, signature-verified, user folder |
 | PHP | Laravel, Raw PHP | `winget` (Windows) · Homebrew (macOS) · apt / dnf / pacman (Linux) |
-| Node.js | Next.js, Express | Already there, since `npx` runs on it |
+| Node.js | Next.js, NestJS, Express, Vite | Already there, since `npx` runs on it |
+| Python 3 | Django, FastAPI | Install from [python.org](https://www.python.org/downloads) (BoilerCraft creates a `.venv` per project) |
+| Go | Go + Gin | Install from [go.dev/dl](https://go.dev/dl) |
 
 Tools installed into the user folder live in `~/.boilercraft/tools` and are added to your user PATH.
 
+### `npx boilercraft doctor`
+
+Doctor is a quick health check. Run it before your first project, when something fails, or paste its output into a bug report.
+
+```bash
+npx boilercraft doctor
+```
+
+It prints three sections:
+
+1. **System**: BoilerCraft version, Node.js version, OS and CPU, and where BoilerCraft keeps the tools it installs.
+2. **Tools**: each tool BoilerCraft can use (Node.js, npm, PHP, Composer, .NET SDK, Python, Go, git, Docker), with the version it found or ✖ *not found*, and which frameworks need it.
+3. **Frameworks**: every framework with ✔ ready or ✖ plus exactly what is missing and where to get it, e.g. `✖ Django · needs Python 3 (https://www.python.org/downloads)`.
+
+Doctor only reads; it never installs or changes anything. It finishes with a line like `7/10 frameworks ready`. The exit code is `0` when every framework is ready and `1` otherwise, so you can use it in CI:
+
+```bash
+npx boilercraft doctor || echo "some toolchains are missing"
+```
+
+To fix what doctor reports, run `npx boilercraft tools` (installs PHP, Composer or the .NET SDK for you) or follow the links it prints. Doctor is also in the main menu as **Run doctor**.
+
+## Presets
+
+Creating the same kind of project often? Save your answers once and skip the questions next time.
+
+- After a project is created, choose **Save these choices as a preset**, or add `--save-preset team-api` to a `new` command.
+- Next time, the menu asks **Start from** a preset, or run `npx boilercraft new my-app --preset team-api`.
+- A preset can also be a JSON file you commit and share with your team: `--preset ./boilercraft.json`.
+
+```json
+{ "stack": "nextjs", "version": "16", "router": "app", "db": "mysql", "extras": ["docker", "ci", "lint"], "theme": "emerald" }
+```
+
+Keys match the CLI flags. Saved presets live in `~/.boilercraft/presets`, and `npx boilercraft presets` lists them.
+
+## Staying up to date
+
+BoilerCraft checks npm for a newer release at most once a day (the result is cached) and shows a notice with the command to update: `npx boilercraft@latest`. Set `BOILERCRAFT_NO_UPDATE_CHECK=1` to turn this off. It is always off in CI.
+
 ## Web studio
 
 Prefer a browser? Choose **Open the web studio** in the menu. You get the same generator as a visual form at `http://localhost:4800`.
@@ -91,6 +151,10 @@ Every question has a flag. Anything you leave out is asked interactively, or tak
 npx boilercraft new shop  -s laravel -v 13 --frontend vue -t emerald -d mysql -y
 npx boilercraft new web   -s nextjs --router pages --no-auth -d mongodb -y
 npx boilercraft new admin -s dotnet-core -v 10 --template mvc -y --install-tools
+npx boilercraft new ui    -s vite --framework vue --language ts -e lint,docker -y
+npx boilercraft new api   -s nestjs -d postgresql -e prisma,docker,ci -y --open
+npx boilercraft new blog  -s django -d postgresql -e docker -y
+npx boilercraft new team  --preset ./boilercraft.json -y
 npx boilercraft --help
 ```
 
@@ -127,7 +191,8 @@ BoilerCraft/
 │   ├── generate.js           # Shared entry for the CLI and web studio
 │   ├── themeGenerator.js     # Theme palettes and dark/light CSS
 │   └── componentGenerator.js # Skeleton, spinner, modal and drawer components
-├── templates/                # Offline fallback templates (and Raw PHP)
+├── templates/                # Offline fallback templates (Raw PHP skeleton too)
+├── test/                     # node --test suite (npm test)
 ├── public/index.html         # Web studio
 └── server.js                 # Web studio API
 ```

package/bin/boilercraft.js

@@ -35,21 +35,36 @@ const HELP = `
   ${c.bold('Automation')} ${c.gray('(scripts / CI, no prompts)')}
     npx boilercraft new <name> [flags]
 
-    -s, --stack <id>        laravel | nextjs | node-express | dotnet-core | raw-php
+    -s, --stack <id>        laravel | nextjs | nestjs | vite | node-express | dotnet-core
+                            django | fastapi | go-gin | raw-php
     -v, --version <major>   Framework major version (default: recommended)
         --auth / --no-auth  Authentication module (default: on)
         --router <type>     app | pages          (Next.js, default: app)
         --frontend <name>   blade | vue | react  (Laravel, default: blade)
         --template <type>   mvc | api            (.NET, default: mvc)
+        --framework <name>  react | vue | svelte (Vite, default: react)
+        --language <lang>   ts | js              (Vite, default: ts)
     -t, --theme <name>      midnight | emerald | royal | crimson
     -m, --mode <mode>       all | dark | light
-    -d, --db <name>         mysql | mssql | mongodb
+    -d, --db <name>         mysql | mssql | mongodb | postgresql | sqlite | none
         --styling <name>    tailwind | bootstrap | vanilla
+    -e, --extras <list>     docker,ci,lint,prisma   (comma separated)
+        --git / --no-git    Initialize a git repository (default: on)
+    -p, --preset <name>     Use a saved preset or a JSON file for the answers
+        --save-preset <n>   Save this run's answers as a preset
+        --open              Open the project in your editor when done
+        --editor <cmd>      Editor for --open (default: code, e.g. cursor)
     -o, --out <dir>         Parent folder (default: current directory)
     -y, --yes               Defaults for anything not given
         --install-tools     Install missing PHP / Composer / .NET SDK automatically
         --no-fallback       Fail instead of using offline templates
     -h, --help              This help
+
+  ${c.bold('Other commands')}
+    npx boilercraft doctor     Report installed tools and which frameworks are ready
+    npx boilercraft tools      Install PHP, Composer or the .NET SDK
+    npx boilercraft list       Frameworks and live versions
+    npx boilercraft presets    Saved presets
 `;
 
 async function main() {
@@ -65,6 +80,14 @@ async function main() {
       router: { type: 'string' },
       frontend: { type: 'string' },
       template: { type: 'string' },
+      framework: { type: 'string' },
+      language: { type: 'string' },
+      extras: { type: 'string', short: 'e' },
+      git: { type: 'boolean' },
+      preset: { type: 'string', short: 'p' },
+      'save-preset': { type: 'string' },
+      open: { type: 'boolean' },
+      editor: { type: 'string' },
       db: { type: 'string', short: 'd' },
       styling: { type: 'string' },
       port: { type: 'string' },
@@ -86,12 +109,19 @@ async function main() {
   // Non-interactive / scripted use.
   if (command === 'new' || command === 'create') {
     app.printBanner();
-    const given = { ...values, name, installTools: values['install-tools'], noFallback: values.fallback === false };
+    const given = { ...values, name, installTools: values['install-tools'], noFallback: values.fallback === false, savePreset: values['save-preset'] };
     await app.createFlow(given);
+    await app.notifyUpdate();
     return app.goodbye();
   }
   if (command === 'list') return app.browseFlow();
-  if (command === 'doctor' || command === 'tools') return app.toolsFlow();
+  // `doctor` used to open the interactive tools screen; it is now a plain report.
+  if (command === 'doctor') {
+    if (!(await app.doctor())) process.exitCode = 1;
+    return app.notifyUpdate();
+  }
+  if (command === 'tools') return app.toolsFlow();
+  if (command === 'presets') return app.listPresetsFlow();
 
   // `npx boilercraft my-app` → menu-free create with the name filled in.
   app.printBanner();

package/cli/app.js

@@ -7,6 +7,9 @@ const { describeStacks, checkRequirements, getStack } = require('../services/eng
 const { installMissing, canInstall, toolEnv, RECIPES, TOOLS_HOME } = require('../services/engine/toolInstaller');
 const { generate } = require('../services/generate');
 const { THEMES } = require('../services/themeGenerator');
+const { EXTRAS } = require('../services/engine/extras');
+const presets = require('../services/presets');
+const updateNotifier = require('../services/updateNotifier');
 const pkg = require('../package.json');
 
 const { c, log } = ui;
@@ -15,7 +18,9 @@ const AUTHOR = 'ARG RABBI';
 const REPO_URL = 'https://github.com/itrabbi24/BoilerCraft';
 const TAGLINE = 'Production-ready projects on the official tooling · any version · auth · themes';
 
-const LEGACY_STACKS = [{
+// raw-php now has a manifest in stacks/raw-php and runs through the engine.
+// Kept for reference in case a stack without a manifest is needed again.
+/* const LEGACY_STACKS = [{
   id: 'raw-php',
   name: 'Raw PHP (MVC)',
   databases: ['mysql'],
@@ -23,7 +28,7 @@ const LEGACY_STACKS = [{
   versions: [],
   requirements: { ok: true, missing: [] },
   nextSteps: ['php -S localhost:8000 -t public']
-}];
+}]; */
 
 const STACK_HINTS = {
   'laravel': 'Blade · Vue · React',
@@ -32,7 +37,8 @@ const STACK_HINTS = {
   'dotnet-core': 'MVC · Web API · EF Core',
   'raw-php': 'No framework · PDO'
 };
-const DB_LABELS = { mysql: 'MySQL', mssql: 'SQL Server', mongodb: 'MongoDB' };
+const stackHint = s => STACK_HINTS[s.id] || s.description || '';
+const DB_LABELS = { mysql: 'MySQL', mssql: 'SQL Server', mongodb: 'MongoDB', postgresql: 'PostgreSQL', sqlite: 'SQLite', none: 'None' };
 const STYLE_LABELS = { tailwind: 'Tailwind CSS', bootstrap: 'Bootstrap 5', vanilla: 'Plain CSS' };
 const COLOR_MODES = [
   { value: 'all', label: 'Dark + Light', hint: 'with a toggle' },
@@ -47,7 +53,7 @@ const COLOR_MODES = [
 let stacksPromise = null;
 function loadStacks({ refresh = false } = {}) {
   if (!stacksPromise || refresh) {
-    stacksPromise = describeStacks().then(list => [...list, ...LEGACY_STACKS]);
+    stacksPromise = describeStacks(); // was: .then(list => [...list, ...LEGACY_STACKS])
   }
   return stacksPromise;
 }
@@ -99,6 +105,12 @@ function isNewer(latest, current) {
 }
 
 async function checkForUpdate() {
+  return updateNotifier.checkForUpdate(pkg);
+}
+
+// Previous uncached check, replaced by services/updateNotifier.js (once a day, cached).
+// eslint-disable-next-line no-unused-vars
+async function checkForUpdateUncached() {
   try {
     const res = await axios.get('https://registry.npmjs.org/boilercraft/latest', { timeout: 1500 });
     return res.data?.version && isNewer(res.data.version, pkg.version) ? res.data.version : null;
@@ -125,13 +137,32 @@ function versionOption(v) {
   return { value: v.major, label: `${v.major}.x`, short: `${v.major}.x`, hint: `latest ${v.latest}${tags.length ? '  ·  ' + tags.join(', ') : ''}` };
 }
 
-async function askProject(given = {}) {
-  const cwd = path.resolve(given.out || process.cwd());
-  const ask = !given.yes;
+// Asks only when there is a real choice; a single option is picked silently.
+async function choose(ask, question, options, { initial = 0 } = {}) {
+  if (options.length === 1 || !ask) return options[options.length === 1 ? 0 : initial].value;
+  return ui.select(question, options, { initial });
+}
 
+async function askPreset(given) {
+  if (given.preset) return presets.loadPreset(given.preset);
+  if (given.yes || given.stack) return {};
+  const saved = presets.listPresets();
+  if (!saved.length) return {};
+  const pick = await ui.select('Start from', [
+    { value: null, label: 'A fresh project', short: 'Fresh' },
+    ...saved.map(p => ({ value: p.name, label: `Preset: ${p.name}`, short: p.name, hint: [p.stack, p.db, ...(p.extras || [])].filter(Boolean).join(' · ') }))
+  ]);
+  return pick ? presets.loadPreset(pick) : {};
+}
+
+async function askProject(given = {}) {
   console.log(ui.divider('New project'));
   console.log('');
 
+  given = { ...(await askPreset(given)), ...given };
+  const cwd = path.resolve(given.out || process.cwd());
+  const ask = !given.yes;
+
   const projectName = given.name
     ? (() => {
         const err = validateName(given.name, cwd);
@@ -150,7 +181,7 @@ async function askProject(given = {}) {
           value: s,
           label: s.name,
           short: s.name,
-          hint: s.requirements.ok ? STACK_HINTS[s.id] : c.yellow(`needs ${s.requirements.missing.map(m => m.name).join(', ')} · can install`)
+          hint: s.requirements.ok ? stackHint(s) : c.yellow(`needs ${s.requirements.missing.map(m => m.name).join(', ')} · can install`)
         })))
       : stacks[0];
   }
@@ -164,7 +195,7 @@ async function askProject(given = {}) {
         throw new Error(`${stack.name} ${given.version} is not available. Options: ${stack.versions.map(v => v.major).join(', ')}`);
       }
     } else {
-      version = ask ? await ui.select(`${stack.name} version`, stack.versions.map(versionOption), { initial: rec }) : stack.versions[rec].major;
+      version = await choose(ask, `${stack.name} version`, stack.versions.map(versionOption), { initial: rec });
     }
   }
 
@@ -176,12 +207,10 @@ async function askProject(given = {}) {
       throw new Error(`Invalid ${opt.label.toLowerCase()} "${preset}". Options: ${opt.choices.map(ch => ch.value).join(', ')}`);
     }
     const initial = Math.max(0, opt.choices.findIndex(ch => ch.value === opt.default));
-    options[opt.id] = preset ?? (ask
-      ? await ui.select(opt.label, opt.choices.map(ch => ({ ...ch, short: ch.label })), { initial })
-      : opt.choices[initial].value);
+    options[opt.id] = preset ?? await choose(ask, opt.label, opt.choices.map(ch => ({ ...ch, short: ch.label })), { initial });
   }
 
-  const auth = given.auth !== undefined ? given.auth : ask
+  const auth = stack.auth === false ? false : given.auth !== undefined ? given.auth : ask
     ? await ui.select('Authentication', [
         { value: true, label: 'Include authentication', short: 'Included', hint: 'register · login · token' },
         { value: false, label: 'No authentication', short: 'None' }
@@ -202,12 +231,20 @@ async function askProject(given = {}) {
   if (given.db && !stack.databases.includes(given.db)) {
     throw new Error(`${stack.name} supports: ${stack.databases.join(', ')} (got "${given.db}")`);
   }
-  const database = given.db || (ask
-    ? await ui.select('Database', stack.databases.map(d => ({ value: d, label: DB_LABELS[d] || d })))
-    : stack.databases[0]);
-  const styling = given.styling || (ask
-    ? await ui.select('Styling', stack.stylings.map(s => ({ value: s, label: STYLE_LABELS[s] || s })))
-    : stack.stylings[0]);
+  const database = given.db || await choose(ask, 'Database', stack.databases.map(d => ({ value: d, label: DB_LABELS[d] || d })));
+  if (given.styling && !stack.stylings.includes(given.styling)) {
+    throw new Error(`${stack.name} supports styling: ${stack.stylings.join(', ')} (got "${given.styling}")`);
+  }
+  const styling = given.styling || await choose(ask, 'Styling', stack.stylings.map(s => ({ value: s, label: STYLE_LABELS[s] || s })));
+
+  const supported = stack.extras || [];
+  const givenExtras = typeof given.extras === 'string' ? given.extras.split(',').map(x => x.trim()).filter(Boolean) : given.extras;
+  const unknown = (givenExtras || []).filter(x => !supported.includes(x));
+  if (unknown.length) throw new Error(`${stack.name} does not support: ${unknown.join(', ')}. Options: ${supported.join(', ') || 'none'}`);
+  const extras = givenExtras || (ask && supported.length
+    ? await ui.multiSelect('Extras', supported.map(x => ({ value: x, label: EXTRAS[x].label, short: EXTRAS[x].label, hint: EXTRAS[x].hint })))
+    : []);
+  const git = given.git !== undefined ? given.git : ask ? await ui.confirm('Initialize a git repository?', true) : true;
 
   return {
     stack,
@@ -221,6 +258,8 @@ async function askProject(given = {}) {
       colorMode,
       database,
       styling,
+      extras,
+      git,
       port: given.port ? parseInt(given.port, 10) : undefined,
       appTitle: given.title,
       author: given.author,
@@ -241,10 +280,12 @@ function summaryBox(stack, config) {
     ['Project', c.bold(config.projectName)],
     ['Framework', `${stack.name}${version ? ` ${version}.x` : ''}`],
     ...(stack.options || []).map(opt => [opt.label, opt.choices.find(ch => ch.value === config.options?.[opt.id])?.label || '']),
-    ['Auth', config.auth.enabled ? 'Included' : 'None'],
+    ...(stack.auth === false ? [] : [['Auth', config.auth.enabled ? 'Included' : 'None']]),
     ['Theme', `${ui.swatch(THEMES[config.theme].primary)} ${THEMES[config.theme].name} · ${COLOR_MODES.find(m => m.value === config.colorMode)?.label}`],
     ['Database', DB_LABELS[config.database] || config.database],
     ['Styling', STYLE_LABELS[config.styling] || config.styling],
+    ['Extras', config.extras.length ? config.extras.map(x => EXTRAS[x].label).join(', ') : 'None'],
+    ['Git', config.git ? 'Initialize repository' : 'No'],
     ['Location', c.gray(displayPath(path.join(config.outputDir, config.projectName.toLowerCase())))]
   ];
   return ui.box(rows.map(([k, v]) => `${c.gray(k.padEnd(10))} ${v}`), { title: 'Summary' });
@@ -312,7 +353,7 @@ async function runGeneration(config) {
   return { ...result, seconds };
 }
 
-async function afterCreate(stack, result) {
+async function afterCreate(stack, result, config) {
   const rel = path.relative(process.cwd(), result.path) || '.';
   const steps = result.nextSteps || (stack.nextSteps || []);
   console.log('');
@@ -331,6 +372,7 @@ async function afterCreate(stack, result) {
       { value: 'run', label: 'Start the dev server', hint: steps.join('  →  ') },
       hasCode && { value: 'code', label: 'Open in VS Code' },
       { value: 'folder', label: 'Open the project folder' },
+      config && { value: 'preset', label: 'Save these choices as a preset', hint: 'reuse with --preset or from the menu' },
       { value: 'menu', label: 'Back to main menu' },
       { value: 'exit', label: 'Exit' }
     ].filter(Boolean);
@@ -356,6 +398,10 @@ async function afterCreate(stack, result) {
     } else if (action === 'code') {
       openInBackground(`code "${result.path}"`);
       log.ok('Opened in VS Code');
+    } else if (action === 'preset') {
+      const name = await ui.input('Preset name', { initial: `${stack.id}-default`, validate: v => (presets.slug(v) ? null : 'Use letters or numbers') });
+      const file = presets.savePreset(name, presets.presetFromConfig(config, stack));
+      log.ok(`Saved ${c.gray(file)} · next time: ${c.cyan(`npx boilercraft new my-app --preset ${presets.slug(name)}`)}`);
     } else if (action === 'folder') {
       openInBackground(openerFor(result.path));
       log.ok('Opened folder');
@@ -390,14 +436,25 @@ async function createFlow(given = {}) {
     }
 
     const result = await runGeneration(config);
+    if (given.savePreset) {
+      log.ok(`Preset saved: ${presets.savePreset(given.savePreset, presets.presetFromConfig(config, stack))}`);
+    }
+    if (given.open) openEditor(result.path, given.editor);
     if (given.yes || !ui.isTTY) {
       printPlainNextSteps(stack, result);
       return 'exit';
     }
-    return afterCreate(stack, result);
+    return afterCreate(stack, result, config);
   }
 }
 
+// --open, with --editor <cmd> (VS Code by default, e.g. --editor cursor).
+function openEditor(dir, editor) {
+  const cmd = typeof editor === 'string' && editor ? editor : 'code';
+  openInBackground(`${cmd} "${dir}"`);
+  log.ok(`Opening in ${cmd}`);
+}
+
 function printPlainNextSteps(stack, result) {
   const rel = path.relative(process.cwd(), result.path) || '.';
   console.log('');
@@ -413,6 +470,13 @@ function printPlainNextSteps(stack, result) {
 // ---------------------------------------------------------------------------
 
 async function toolStatus() {
+  const first = out => (out ? (out.match(/(\d+\.\d+(\.\d+)?)/) || [])[1] || out.split('\n')[0] : null);
+  const [git, python, go, docker] = await Promise.all([
+    probe('git', ['--version']),
+    probe(process.platform === 'win32' ? 'python' : 'python3', ['--version']),
+    probe('go', ['version']),
+    probe('docker', ['--version'])
+  ]);
   const [npm, php, composer, sdks] = await Promise.all([
     probe('npm', ['--version']),
     probe('php', ['-r', '"echo PHP_VERSION;"']),
@@ -425,7 +489,11 @@ async function toolStatus() {
     { id: 'npm', name: 'npm', version: npm, usedBy: 'Next.js · Express' },
     { id: 'php', name: 'PHP', version: php, usedBy: 'Laravel · Raw PHP' },
     { id: 'composer', name: 'Composer', version: composer && (composer.match(/(\d+\.\d+\.\d+)/) || [])[1], usedBy: 'Laravel' },
-    { id: 'dotnet', name: '.NET SDK', version: sdkList.length ? sdkList.join(', ') : null, usedBy: '.NET' }
+    { id: 'dotnet', name: '.NET SDK', version: sdkList.length ? sdkList.join(', ') : null, usedBy: '.NET' },
+    { id: 'python', name: 'Python', version: first(python), usedBy: 'Django · FastAPI', install: 'https://www.python.org/downloads' },
+    { id: 'go', name: 'Go', version: first(go), usedBy: 'Go + Gin', install: 'https://go.dev/dl' },
+    { id: 'git', name: 'git', version: first(git), usedBy: 'repository setup', install: 'https://git-scm.com' },
+    { id: 'docker', name: 'Docker', version: first(docker), usedBy: 'Docker extra (optional)', install: 'https://docs.docker.com/get-docker' }
   ];
 }
 
@@ -470,6 +538,34 @@ async function toolsFlow() {
   }
 }
 
+/**
+ * `boilercraft doctor`: a plain, non-interactive health report. Lists every
+ * tool, which frameworks are ready right now, and exits 1 if a framework
+ * cannot be created (handy in CI and when reporting an issue).
+ */
+async function doctor() {
+  console.log(ui.divider('Doctor'));
+  console.log('');
+  const [tools, stacks] = await ui.spinner('Checking tools and frameworks…', () => Promise.all([toolStatus(), loadStacks()]));
+  console.log(ui.box([
+    `${c.gray('BoilerCraft'.padEnd(12))} v${pkg.version}`,
+    `${c.gray('Node.js'.padEnd(12))} ${process.version}`,
+    `${c.gray('Platform'.padEnd(12))} ${process.platform} ${process.arch}`,
+    `${c.gray('Tools home'.padEnd(12))} ${TOOLS_HOME}`
+  ], { title: 'System' }));
+  console.log(ui.box(tools.map(t => {
+    const mark = t.version ? c.green('✔') : c.yellow('✖');
+    return `${mark} ${t.name.padEnd(10)} ${(t.version || c.yellow('not found')).padEnd(18)} ${c.gray(t.usedBy)}`;
+  }), { title: 'Tools' }));
+  console.log(ui.box(stacks.map(s => s.requirements.ok
+    ? `${c.green('✔')} ${s.name}`
+    : `${c.yellow('✖')} ${s.name} ${c.gray('· needs ' + s.requirements.missing.map(m => `${m.name}${m.install ? ` (${m.install})` : ''}`).join(', '))}`
+  ), { title: 'Frameworks' }));
+  const ready = stacks.filter(s => s.requirements.ok).length;
+  console.log(`\n  ${ready}/${stacks.length} frameworks ready.${ready < stacks.length ? ` Run ${c.cyan('npx boilercraft tools')} to install PHP, Composer or .NET for you.` : ''}\n`);
+  return ready === stacks.length;
+}
+
 // ---------------------------------------------------------------------------
 // Browse / About / Web studio
 // ---------------------------------------------------------------------------
@@ -480,7 +576,7 @@ async function browseFlow() {
   const stacks = await ui.spinner('Loading frameworks and latest versions…', () => loadStacks());
   for (const s of stacks) {
     const status = s.requirements.ok ? c.green('● ready') : c.yellow(`○ needs ${s.requirements.missing.map(m => m.name).join(', ')}`);
-    const lines = [`${status}   ${c.gray(STACK_HINTS[s.id] || '')}`];
+    const lines = [`${status}   ${c.gray(stackHint(s))}`];
     if (s.versions.length) {
       lines.push('');
       for (const v of s.versions) {
@@ -491,7 +587,7 @@ async function browseFlow() {
     lines.push('', `${c.gray('Databases')}  ${s.databases.map(d => DB_LABELS[d] || d).join(', ')}`);
     console.log(ui.box(lines, { title: s.name }));
   }
-  console.log(`\n  ${c.gray('Versions are fetched live from npm, Packagist and the .NET release index,')}`);
+  console.log(`\n  ${c.gray('Versions are fetched live from npm, Packagist, PyPI, the Go proxy and .NET,')}`);
   console.log(`  ${c.gray('so new framework releases appear here automatically.')}\n`);
   await ui.select('Done?', [{ value: 'back', label: 'Back to main menu' }]);
 }
@@ -564,8 +660,9 @@ async function home() {
     let action;
     try {
       action = await ui.select('What would you like to do?', [
-        { value: 'create', label: 'Create a new project', hint: 'Laravel · Next.js · Express · .NET · PHP' },
+        { value: 'create', label: 'Create a new project', hint: 'Laravel · Next.js · NestJS · Vite · Django · FastAPI · Go · .NET' },
         { value: 'tools', label: 'Check & install tools', hint: 'PHP · Composer · .NET SDK' },
+        { value: 'doctor', label: 'Run doctor', hint: 'what is installed, what is ready' },
         { value: 'browse', label: 'Browse frameworks & versions' },
         { value: 'web', label: 'Open the web studio', hint: 'same features in your browser' },
         { value: 'about', label: 'About BoilerCraft' },
@@ -583,6 +680,7 @@ async function home() {
         if ((await createFlow()) === 'exit') return goodbye();
       } else if (action === 'tools') await toolsFlow();
       else if (action === 'browse') await browseFlow();
+      else if (action === 'doctor') await doctor();
       else if (action === 'web') await webFlow();
       else if (action === 'about') await aboutFlow();
     } catch (err) {
@@ -593,4 +691,23 @@ async function home() {
   }
 }
 
-module.exports = { home, createFlow, toolsFlow, browseFlow, printBanner, goodbye, AUTHOR };
+function listPresetsFlow() {
+  const saved = presets.listPresets();
+  console.log('');
+  if (!saved.length) {
+    log.info(`No presets yet. Create a project and choose "Save these choices as a preset", or pass ${c.cyan('--save-preset <name>')}.`);
+  } else {
+    console.log(ui.box(saved.map(p => `${c.bold(p.name.padEnd(18))} ${c.gray([p.stack, p.version && `v${p.version}`, p.db, ...(p.extras || [])].filter(Boolean).join(' · '))}`), { title: 'Presets' }));
+    console.log(`\n  ${c.gray(`Stored in ${presets.PRESETS_DIR}`)}`);
+    console.log(`  ${c.gray('Use:')} ${c.cyan(`npx boilercraft new my-app --preset ${saved[0].name}`)}`);
+  }
+  console.log('');
+}
+
+// Shown after scripted commands; the menu shows it at the top instead.
+async function notifyUpdate() {
+  const latest = await Promise.race([checkForUpdate(), new Promise(r => setTimeout(() => r(null), 1500))]);
+  if (latest) console.log(ui.box([`Update available ${c.gray(pkg.version)} → ${c.green(latest)}`, `Run ${c.cyan('npx boilercraft@latest')}`], { color: c.yellow }));
+}
+
+module.exports = { home, createFlow, toolsFlow, browseFlow, doctor, notifyUpdate, listPresetsFlow, printBanner, goodbye, AUTHOR };

package/cli/ui.js

@@ -260,6 +260,72 @@ async function selectPlain(question, options, initial) {
   throw new CancelError();
 }
 
+/**
+ * Checkbox list. options: [{ value, label, hint, checked }]
+ * Space toggles, "a" toggles all, Enter confirms. Returns the chosen values.
+ */
+async function multiSelect(question, options) {
+  const picked = new Set(options.filter(o => o.checked).map(o => o.value));
+  if (!isTTY) {
+    console.log(`  ${c.cyan('?')} ${c.bold(question)}`);
+    options.forEach((o, i) => console.log(`    ${String(i + 1).padStart(2)}) ${o.label}${o.hint ? c.gray(`  ${o.hint}`) : ''}`));
+    process.stdout.write(`    ${c.gray('numbers, comma separated (blank = none):')} `);
+    const answer = await nextLine();
+    if (answer === null) throw new CancelError();
+    process.stdout.write(`${answer}\n`);
+    return answer.split(',').map(n => options[parseInt(n, 10) - 1]).filter(Boolean).map(o => o.value);
+  }
+
+  let index = 0;
+  return new Promise((resolve, reject) => {
+    const out = process.stdout;
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    out.write('\x1b[?25l');
+    out.write(truncate(`  ${c.cyan('?')} ${c.bold(question)} ${c.gray('· space to toggle, enter to confirm')}`, columns() - 1) + '\n');
+    const render = first => {
+      if (!first) out.write(`\x1b[${options.length}A`);
+      options.forEach((o, i) => {
+        const mark = picked.has(o.value) ? c.green('◉') : c.gray('◯');
+        const label = i === index ? c.cyan(c.bold(o.label)) : o.label;
+        const full = `    ${i === index ? c.cyan('❯') : ' '} ${mark} ${label}${o.hint ? `  ${c.gray(o.hint)}` : ''}`;
+        out.write(`\x1b[2K${width(full) <= columns() - 1 ? full : truncate(full, columns() - 1)}\n`);
+      });
+    };
+    render(true);
+    const finish = () => {
+      process.stdin.removeListener('keypress', onKey);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      out.write(`\x1b[${options.length + 1}A\x1b[0J\x1b[?25h`);
+    };
+    const onKey = (str, key = {}) => {
+      if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+        finish();
+        return reject(new CancelError());
+      }
+      if (key.name === 'up' || key.name === 'k') index = (index - 1 + options.length) % options.length;
+      else if (key.name === 'down' || key.name === 'j' || key.name === 'tab') index = (index + 1) % options.length;
+      else if (key.name === 'space') {
+        const v = options[index].value;
+        if (picked.has(v)) picked.delete(v);
+        else picked.add(v);
+      } else if (str === 'a') {
+        if (picked.size === options.length) picked.clear();
+        else options.forEach(o => picked.add(o.value));
+      } else if (key.name === 'return' || key.name === 'enter') {
+        finish();
+        const chosen = options.filter(o => picked.has(o.value));
+        out.write(`  ${c.green('✔')} ${c.bold(question)} ${c.gray('·')} ${c.cyan(chosen.length ? chosen.map(o => o.short || stripAnsi(o.label)).join(', ') : 'None')}\n`);
+        return resolve(chosen.map(o => o.value));
+      }
+      render(false);
+    };
+    process.stdin.on('keypress', onKey);
+  });
+}
+
 async function confirm(question, initial = true) {
   return select(question, [
     { value: true, label: 'Yes', short: 'Yes' },
@@ -353,4 +419,4 @@ const log = {
   info: msg => console.log(`  ${c.blue('ℹ')} ${msg}`)
 };
 
-module.exports = { truncate, c, isTTY, swatch, gradient, banner, box, divider, input, select, confirm, spinner, tasks, log, width, stripAnsi, CancelError };
+module.exports = { truncate, c, isTTY, swatch, gradient, banner, box, divider, input, select, multiSelect, confirm, spinner, tasks, log, width, stripAnsi, CancelError };