Angelo.Scaffold

Interactive scaffolding tool for Angelo.* packages.

Angelo.Scaffold provides a seamless way to scaffold files from Angelo packages into your project with smart merging capabilities, namespace adjustment, and an interactive terminal UI.

Installation

dotnet add package Angelo.Scaffold

Usage

Add a single line at the start of your Program.cs:

using Angelo.Scaffold.Extensions; Scaffold.Enable(); var builder = WebApplication.CreateBuilder(args); // ... rest of your code

When you run your app in Debug mode, a separate terminal window will open with the scaffolding interface.

Terminal Interface

Angelo Scaffold v1.0.0 ╭──────────────────────────────────────────────────╮ │ Project MyWebApp │ │ Location C:\Projects\MyWebApp │ ╰──────────────────────────────────────────────────╯ Select an action > Scan for Angelo packages Scaffold from package View scaffold history Re-scaffold (update) Exit

Workflow

1. Scan to discover installed Angelo packages with scaffold support
2. Select a package to scaffold from
3. Choose which files to scaffold
4. Review diffs for existing files
5. Confirm merges for special files (appsettings.json, DbContext, Program.cs)

Configuration

Scaffold.Enable(config => { config.DebugModeOnly = true; // Only run in debug mode (default: true) config.CreateBackups = true; // Backup files before overwriting (default: true) config.TerminalTitle = "My Scaffold"; // Custom terminal window title });

Alternative: WebApplicationBuilder Extension

var builder = WebApplication.CreateBuilder(args); builder.UseAngeloScaffold(); // ... rest of your code

Features

• Auto-discovery - Automatically scans for installed Angelo.* packages with scaffold support
• 1:1 Folder Mapping - Scaffold files maintain their folder structure
• Smart Merging - Intelligently merges JSON configs, Program.cs, and DbContext files
• Namespace Adjustment - Automatically adjusts namespaces to match your project
• Version Tracking - Keeps track of what was scaffolded for easy updates
• Backups - Creates backups before overwriting files
• Diff Comparison - Shows differences before overwriting existing files

Merge Strategies

File Type	Strategy	Behavior
appsettings.json	JSON Merge	Deep merges keys, preserves existing values
Program.cs	Roslyn Merge	Adds usings, services, and middleware at markers
*DbContext.cs	DbContext Merge	Adds DbSets and OnModelCreating configurations
All other files	Copy	Copies with namespace adjustment for .cs files

License

MIT