@libria/scaffold 0.3.6 → 0.3.7

package/.clean-publish.hash

@@ -1 +1 @@
-118d651e61570cc85596e855535faf1ab6abebdee7f89daa278753ec48c7f6a1
+14624322df52dd5c41679e44f6151e38e2318fe584a01e6154d03738012bb764

package/README.md

@@ -13,7 +13,8 @@ Forge your next project with lightning-fast scaffolding. A pluggable CLI that tr
 - **NPM Package Support**: Load templates from npm packages
 - **Dry Run Mode**: Preview what will be generated before committing
 - **Force Overwrite**: Safely regenerate existing projects
-- **Template Plugins**: Angular, NestJS, TypeScript libraries, and workspaces
+- **Global + Local Config**: Global `~/.lbscaffold.json` defaults with local per-key overrides
+- **Template Plugins**: Angular, NestJS, Next.js, TypeScript libraries, and workspaces
 
 ## Installation
 
@@ -103,7 +104,7 @@ A modern TypeScript library template with:
 
 A complete Angular application template using the official Angular CLI. Supports:
 
-- Angular versions: Latest, 20, 19, 18, 17, 16
+- Angular versions: Latest, 21, 20, 19, 18, 17, 16
 - Stylesheet formats: SCSS, CSS, Sass, Less
 - Optional routing module
 - Optional Server-Side Rendering (SSR)
@@ -144,43 +145,81 @@ lb-scaffold new nestjs my-nest-api
 - Skip git initialization?
 - Skip package installation?
 
+### nextjs
+
+A Next.js application template using the official `create-next-app`. Supports:
+
+- Tailwind CSS (enabled by default)
+- TypeScript or JavaScript
+- App Router, API-only, or empty project types
+- Turbopack or Webpack bundler
+- ESLint, Biome, or no linter
+- Package manager choice: npm, Yarn, pnpm, or Bun
+
+```bash
+lb-scaffold new nextjs my-next-app
+```
+
+**Interactive prompts:**
+- Next.js version
+- Language (TypeScript/JavaScript)
+- Enable Tailwind CSS?
+- Bundler (Turbopack/Webpack)
+- Project type (app/api/empty)
+
 ### ts-workspace
 
-A TypeScript workspace (monorepo) template using pnpm workspaces. Creates a monorepo with multiple project types:
+A TypeScript workspace (monorepo) template using npm workspaces and TypeScript project references. Provides two subcommands:
+
+- **`init`** — Create a new workspace with shared tsconfig, package.json workspaces, and git setup
+- **`add`** — Add projects into an existing workspace using other templates (ts-lib, angular, nestjs, nextjs)
 
-- TypeScript libraries (ts-lib)
-- Angular applications
-- NestJS backends
-- Shared packages
-- pnpm workspace configuration
-- Turbo or Nx for monorepo tooling (optional)
+Automatically manages workspace `package.json` entries, TypeScript project references, and tsconfig inheritance.
 
 ```bash
+# Create a new workspace
 lb-scaffold new ts-workspace my-monorepo
+
+# Add a project into the workspace
+lb-scaffold new ts-workspace my-lib --workspace ./my-monorepo --template ts-lib
 ```
 
-**Interactive prompts:**
-- Project types to include
-- Monorepo tool (Turbo, Nx, or none)
-- Skip git initialization?
-- Skip package installation?
+**Interactive prompts (init):**
+- Package manager (npm, Yarn, pnpm)
+- Initialize git repository?
+
+**Interactive prompts (add):**
+- Workspace root path
+- Template to use
+- Base path for the new project
 
 ## Configuration
 
 The scaffold CLI supports a configuration file (`.lbscaffold.json`) that allows you to register custom plugin directories and npm packages. This enables you to use your own templates alongside the built-in ones.
 
-### Config File Location
+### Config File Locations
+
+The CLI supports two config file locations:
 
-The CLI searches for `.lbscaffold.json` starting from the current directory and walking up the directory tree. This allows you to have project-specific or workspace-level configurations.
+- **Global**: `~/.lbscaffold.json` — provides machine-wide defaults
+- **Local**: `.lbscaffold.json` found by searching up from the current directory
+
+When both exist, local keys override global keys on a per-key basis. For example, if the local config defines `plugins`, it fully replaces the global `plugins`; keys not present locally fall through to the global config.
 
 ### Config Commands
 
-Initialize a new config file:
+Initialize a new config file in the current directory:
 
 ```bash
 lb-scaffold config init
 ```
 
+Initialize the global config file:
+
+```bash
+lb-scaffold config init -g
+```
+
 This creates a `.lbscaffold.json` file with a default plugin path:
 
 ```json
@@ -194,6 +233,9 @@ Add a custom plugin directory:
 
 ```bash
 lb-scaffold config add ./my-templates/**
+
+# Add to global config
+lb-scaffold config add ./my-templates/** -g
 ```
 
 Remove a plugin directory:
@@ -202,18 +244,26 @@ Remove a plugin directory:
 lb-scaffold config remove ./my-templates/**
 ```
 
-List all configured plugin patterns:
+List all configured plugin patterns (shows merged config with source indicators):
 
 ```bash
 lb-scaffold config list
+
+# Show only global config
+lb-scaffold config list -g
 ```
 
 Show the full config file:
 
 ```bash
 lb-scaffold config show
+
+# Show only global config
+lb-scaffold config show -g
 ```
 
+All config subcommands accept `-g` / `--global` to target the global config (`~/.lbscaffold.json`) instead of the local one.
+
 ### Config File Format
 
 The `.lbscaffold.json` config file is a JSON file with the following structure:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libria/scaffold",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "A pluggable CLI that transforms blank directories into production-ready codebases in seconds",
   "main": "dist/cli/index.cjs",
   "module": "dist/cli/index.mjs",
@@ -36,17 +36,17 @@
   "homepage": "https://github.com/LibriaForge/scaffold#readme",
   "dependencies": {
     "@libria/plugin-loader": "^2.1.0",
-    "@libria/scaffold-core": "^0.3.6",
+    "@libria/scaffold-core": "^0.3.7",
     "commander": "^14.0.3",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.3",
     "interactive-commander": "^0.6.0"
   },
   "optionalDependencies": {
-    "@libria/scaffold-plugin-angular": "^0.0.5",
-    "@libria/scaffold-plugin-nestjs": "^0.0.4",
-    "@libria/scaffold-plugin-nextjs": "^0.0.2",
-    "@libria/scaffold-plugin-ts-lib": "^0.0.6",
-    "@libria/scaffold-plugin-ts-workspace": "^0.0.5"
+    "@libria/scaffold-plugin-angular": "^0.0.6",
+    "@libria/scaffold-plugin-nestjs": "^0.0.5",
+    "@libria/scaffold-plugin-nextjs": "^0.0.3",
+    "@libria/scaffold-plugin-ts-lib": "^0.0.7",
+    "@libria/scaffold-plugin-ts-workspace": "^0.0.6"
   }
 }