🎯

blazor

🎯Skill
g1joshi/agent-skills1 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill blazor

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/blazor
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/blazor/
  • All projects ~/.claude/skills/blazor/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Expert Blazor assistance covering WebAssembly, Server-Side Blazor, Razor components, and C# browser interactivity. Use when building interactive web UIs using C# instead of JavaScript.

Blazor

Blazor enables full-stack web UI development using C# and .NET, offering flexible rendering architectures including Blazor Server, Blazor WebAssembly, and hybrid static server streaming.

When to Use

  • Interactive Full-Stack Web Apps in C#: Building rich browser UIs without writing separate JavaScript codebases.
  • Blazor Web App Unified Model (.NET 8/9): Mixing Server, WebAssembly, and Static Server-Side Rendering per component.
  • Enterprise Internal Dashboards: Utilizing high-productivity component libraries (MudBlazor, Fluent UI Blazor).
  • Offline Progressive Web Apps: Compiling C# directly into WebAssembly for client-side offline execution.

Quick Start

@page "/counter"
@rendermode InteractiveServer

<PageTitle>Counter</PageTitle>

<h1>Counter</h1>

<p role="status">Current count: @currentCount</p>

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>

@code {
    private int currentCount = 0;

    private void IncrementCount()
    {
        currentCount++;
    }
}

Core Concepts

Render Modes & Reactive Parameters

Declaring component interactivity per page or component:

@page "/counter"
@rendermode InteractiveServer

<PageTitle>Counter</PageTitle>

<div class="card p-4">
    <h3>Current count: @currentCount</h3>
    <button class="btn btn-primary" @onclick="IncrementCount">Click me</button>
</div>

@code {
    private int currentCount = 0;

    [Parameter]
    public int IncrementStep { get; set; } = 1;

    private void IncrementCount()
    {
        currentCount += IncrementStep;
    }
}

Two-Way Binding & EventCallback

Passing events and state between parent and child components:

<!-- ChildComponent.razor -->
<div class="search-box">
    <input value="@SearchTerm" @oninput="OnInputChanged" placeholder="Search..." />
</div>

@code {
    [Parameter]
    public string SearchTerm { get; set; } = string.Empty;

    [Parameter]
    public EventCallback<string> SearchTermChanged { get; set; }

    private async Task OnInputChanged(ChangeEventArgs e)
    {
        var newValue = e.Value?.ToString() ?? string.Empty;
        await SearchTermChanged.InvokeAsync(newValue);
    }
}

Dependency Injection & Cascading Authentication State

Accessing user security context in Blazor components:

@inject NavigationManager Navigation
@inject IOrderService OrderService

<AuthorizeView>
    <Authorized>
        <p>Welcome, @context.User.Identity?.Name!</p>
        <button class="btn btn-success" @onclick="LoadOrders">Fetch Orders</button>
    </Authorized>
    <NotAuthorized>
        <p>Please log in to view your orders.</p>
        <a href="/login">Login</a>
    </NotAuthorized>
</AuthorizeView>

@code {
    private async Task LoadOrders()
    {
        var orders = await OrderService.GetUserOrdersAsync();
    }
}

Common Patterns

Two-Way Component Parameter Binding

Problem: Passing state down to child components while bubbling state modifications back up cleanly.

Solution: Use @bind-Value and EventCallback conventions:

<!-- ChildComponent.razor -->
<input value="@Value" @oninput="OnInputChanged" />

@code {
    [Parameter] public string Value { get; set; } = "";
    [Parameter] public EventCallback<string> ValueChanged { get; set; }

    private async Task OnInputChanged(ChangeEventArgs e)
    {
        await ValueChanged.InvokeAsync(e.Value?.ToString());
    }
}

<!-- ParentComponent.razor: <ChildComponent @bind-Value="searchTerm" /> -->

Best Practices

Do:

  • Target the .NET 8/9 Blazor Web App unified project template with auto render modes (InteractiveAuto).
  • Implement IDisposable or IAsyncDisposable on components subscribing to C# events to avoid memory leaks.
  • Use Virtualize<TItem> for rendering large lists to render only elements within the viewport.
  • Keep state centralized in injected scoped services rather than sprawling across UI components.

Don't:

  • Use synchronous blocking I/O calls (.Result) in component methods; use async/await.
  • Pass large binary data over Blazor Server SignalR circuits; use dedicated streaming API endpoints.
  • Trigger unnecessary StateHasChanged() calls if standard event callbacks already trigger re-rendering.

Troubleshooting

ErrorCauseSolution
InvalidOperationException: Cannot provide a value for property ...Missing @inject directive or service not registered in Program.cs.Register service in builder.Services.AddScoped<MyService>().
Blazor circuit disconnected / reconnecting loopUnhandled exception crashed the SignalR circuit on the server.Wrap event handlers in try/catch and inspect server console logs.
WASM: Out of memory during large data fetchLarge response payload deserialization exceeding WASM memory limits.Paginate API responses or use streaming deserialization with System.Text.Json.

References

More from this repository10