Create Datadriven Aspnetcore

Generate or Scaffold ASP.NET Core Code

Generate ASP.NET Core scaffolded code — controllers, views, Razor Pages, Blazor components, Minimal API endpoints. The generated code matches the project's existing CSS framework, layout conventions, and coding patterns. No CLI-based scaffolding/code-generation tools are used; standard dotnet CLI commands for build, restore, and migrations are still expected.

When to Use

• Adding CRUD pages, views, or components for a model in an ASP.NET Core project
• Scaffolding API controllers or Minimal API endpoints with Entity Framework Core
• Generating Razor Pages, MVC views, or Blazor components backed by a DbContext

When Not to Use

• The project is not an ASP.NET Core project
• You need to scaffold non-web artifacts (class libraries, console apps, etc.)

Inputs

Scaffolding Request Format

The scaffolding request should be a natural-language description of what to scaffold. The request must include the target project path and enough detail for the agent to generate the correct code. Examples:

Razor Pages with EF:

Scaffold Razor Pages with CRUD for the `<ModelName>` model (from `<Namespace>`) in project `<path-to-csproj>`.
Create a new DbContext `<DbContextName>` using <database-provider>.
Also scaffold CRUD for any entity that `<ModelName>` depends on via required foreign keys, so parent entities can be created first.

Blazor CRUD components:

Scaffold Blazor CRUD components for the `<ModelName>` model (from `<Namespace>`) in project `<path-to-csproj>`.
Create a new DbContext `<DbContextName>` using <database-provider>.

Minimal API endpoints:

Scaffold Minimal API endpoints for the `<ModelName>` model (from `<Namespace>`) in project `<path-to-csproj>`.
Name the endpoints class `<EndpointsClassName>`.
Create a new DbContext `<DbContextName>` using <database-provider>.
Enable OpenAPI support.

MVC Controller with views:

Scaffold an MVC controller with views and Entity Framework for the `<ModelName>` model (from `<Namespace>`) in project `<path-to-csproj>`.
Name the controller `<ControllerName>`.
Use existing DbContext `<DbContextName>`.
Generate views.

Empty items (no EF):

Scaffold an empty Razor Page named `<PageName>` in project `<path-to-csproj>`.

Workflow

Step 1: Understand the Scaffolding Request

Parse the scaffolding request to identify:

• Scaffolder type: Razor Pages, Blazor components, MVC controller, Minimal API, empty page/view/component
• Model class and its namespace
• DbContext: new or existing, database provider (SQLite, SQL Server, etc.)
• Named items: controller name, endpoints class name, page name, view name, area name
• Options: OpenAPI, async actions, partial view, custom layout
• FK scope: whether to also scaffold CRUD for parent entities referenced by required foreign keys

Execution Checklists

Complete the applicable checklist in order. Do not stop after creating only the requested child resource when a required foreign key makes a parent resource necessary.

All EF scaffolders

1. Inspect the project file, Program.cs, target model, validation attributes, navigation properties, and foreign keys before editing.
2. Reuse the requested existing DbContext; otherwise create the requested context. Add only the required provider package and register it with AddDbContext using the requested provider and connection string. You will need to add Microsoft.EntityFrameworkCore.Design (PrivateAssets="all") when migrations are needed and it's missing.
3. Generate complete CRUD for the requested entity and every required parent entity: list, details, create, edit, and delete.
4. Use the EF migration lifecycle: create a migration and apply it. Never call EnsureCreated or seed the database in Program.cs.
5. Restore, build, and test the generated project. Fix errors before reporting completion.

MVC, Razor Pages, and Blazor

1. Inspect the existing layout, CSS, and representative UI before generating markup.
2. Generate the complete child and required-parent UI flows, including a navigation path to each resource so users can create a parent before creating a child.
3. Match the existing UI framework and conventions; preserve existing render-mode configuration for Blazor.

Minimal APIs

1. Use a route group for each resource and map GET (list and by ID), POST, PUT, and DELETE endpoints for both child and required-parent resources.
2. Add OpenAPI metadata to every endpoint: unique name, tags, description, success/error response metadata, and WithOpenApi when OpenAPI is enabled.
3. Create an executable .http file with every CRUD request. Create parent records first, capture or clearly reuse their returned IDs in child requests, and run the requests in dependency order.

Step 2: Discover UI Style (non-API scaffolders only)

Skip this step for API controllers and Minimal API endpoints.

1. Inspect the project's layout file (_Layout.cshtml, MainLayout.razor, or equivalent)
2. Inspect the main CSS file (site.css, app.css, Tailwind config, etc.)
3. Inspect 1–2 existing pages, views, or components in the project

All generated files MUST match the existing UI framework, CSS classes, and conventions. If Bootstrap is used, generate Bootstrap markup. If Tailwind is used, generate Tailwind markup.

Step 3: Apply Blazor-Specific Rules (Blazor scaffolders only)

Skip this step for non-Blazor scaffolders.

• [SupplyParameterFromForm] properties MUST use = new() (not null!) — prevents EditForm crash on initial GET
• Program.cs must chain .AddInteractiveServerComponents() on AddRazorComponents() and .AddInteractiveServerRenderMode() on MapRazorComponents<App>(). only add interactive server services/render mode when the generated components actually use @rendermode InteractiveServer (or the project already does).
• Do not replace existing chained render mode calls (e.g., .AddInteractiveWebAssemblyRenderMode())

Step 4: Generate Code

Generate all code files manually. Follow these constraints:

• DO NOT use any scaffolding CLI tools
• DO NOT add packages beyond those required for the scaffolded functionality (e.g., do not add RuntimeCompilation, or other convenience packages)
• Match the coding style of existing files in the project (naming conventions, indentation, namespace patterns)

Enrich API Endpoints with OpenAPI Metadata (API scaffolders only)

When generating Minimal API or MVC API endpoints with OpenAPI support enabled, add rich metadata to every endpoint so the OpenAPI document is descriptive and useful:

• .WithName("GetTodoItems") — unique operation ID for each endpoint
• .WithTags("TodoItems") — group endpoints by resource
• .WithDescription("Returns all todo items") — human-readable summary
• .Produces<List<TodoItem>>(StatusCodes.Status200OK) — document success response type
• .Produces(StatusCodes.Status404NotFound) — document error responses
• .ProducesValidationProblem() — for endpoints that validate input
• .WithOpenApi() — opt the endpoint into OpenAPI generation (if not already globally enabled)

Example for a Minimal API GET endpoint:

group.MapGet("/", async (TodoDbContext db) =>
        await db.TodoItems.ToListAsync())
    .WithName("GetAllTodoItems")
    .WithTags("TodoItems")
    .WithDescription("Returns all todo items")
    .Produces<List<TodoItem>>(StatusCodes.Status200OK);