version: "1.0.0"

name: webforms-to-blazor-upgrade description: > Upgrade ASP.NET Web Forms projects to modern .NET. Use when the user wants to upgrade, migrate, modernize, port, convert, or move Web Forms / WebForms / .aspx pages to any modern .NET. framework. metadata: discovery: scenario importance: high traits: (.NET|CSharp|VisualBasic) & DotNetFramework & WebForms scenarioTraitsSet: ".NET|DotNetFramework|WebForms"

Web Forms to Blazor Upgrade Scenario

This scenario uses the dotnet-version-upgrade scenario workflow. The only differences are intent detection and target technology selection — this skill matches Web Forms upgrade requests specifically and always targets Blazor (Blazor Server) as the modernization destination.

Target Technology — Default Lock with Opt-Out

When Web Forms (.aspx, .ascx, .master, .asmx, System.Web.UI, <%@ Page %> directives, server controls, Global.asax, WebForm project type GUID {349C5851-65DF-11DA-9384-00065B846F21}) is detected, the default and strongly recommended upgrade target is Blazor Server. Blazor Server is the only target with full, validated support in this scenario.

When the user explicitly insists on a non-Blazor target

If — and only if — the user explicitly asks to target Razor Pages, ASP.NET Core MVC, Minimal APIs, Web API, or another non-Blazor framework, honor their choice rather than refusing. Before proceeding, deliver a clear warning once and get acknowledgment:

⚠️ Unsupported target warning

This scenario is designed and validated for migrating Web Forms projects to Blazor Server. You've asked to target {user's choice} instead.

- There is no first-class support in this scenario for {user's choice}.

- Expect reduced guidance, more manual decisions, and a higher chance of incomplete or incorrect transformations.

- Assessment and high-level planning will still work, but execution will rely on general .NET knowledge rather than scenario-specific patterns.

Do you want to proceed with {user's choice} anyway, or switch to the recommended Blazor Server target?

Workflow

Follow the dotnet-version-upgrade scenario skill for all stages (assessment, planning, execution).