Web Hosting

ASP.NET applications often end up with a bloated Program.cs where every cross-cutting concern — authentication, CORS, Swagger, logging, health checks — is mixed together. Shiny Web Hosting lets you break that apart into modular IWebModule classes, each responsible for its own service registration and middleware configuration, keeping your startup clean.

• 
• 

Frameworks

ASP.NET

Features

• Modular IWebModule interface — combines service registration and middleware configuration in one class
• Explicit registration for reflection-free, AOT-compatible setups
• Clean separation of concerns — one module per infrastructure component

Setup

1. Install the NuGet package:

   dotnet add package Shiny.Extensions.WebHosting

2. Create web modules for each concern:

   using Shiny;
   
   public class SwaggerModule : IWebModule
   {
       public void Add(WebApplicationBuilder builder)
       {
           builder.Services.AddEndpointsApiExplorer();
           builder.Services.AddSwaggerGen();
       }
   
       public void Use(WebApplication app)
       {
           if (app.Environment.IsDevelopment())
           {
               app.UseSwagger();
               app.UseSwaggerUI();
           }
       }
   }

3. Wire up modules in Program.cs:

   using Shiny;
   
   var builder = WebApplication.CreateBuilder(args);
   builder.AddInfrastructureModules(new SwaggerModule());
   
   var app = builder.Build();
   app.UseInfrastructureModules();
   
   app.Run();

Creating Modules

Each module implements IWebModule with two methods:

• Add(WebApplicationBuilder builder) — register services, configuration, and anything that happens before Build()
• Use(WebApplication app) — configure middleware, endpoints, and anything that happens after Build()

public class CorsModule : IWebModule
{
    public void Add(WebApplicationBuilder builder)
    {
        builder.Services.AddCors(options =>
        {
            options.AddDefaultPolicy(policy =>
                policy.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader());
        });
    }

    public void Use(WebApplication app)
    {
        app.UseCors();
    }
}

public class AuthModule : IWebModule
{
    public void Add(WebApplicationBuilder builder)
    {
        builder.Services.AddAuthentication()
            .AddJwtBearer();
        builder.Services.AddAuthorization();
    }

    public void Use(WebApplication app)
    {
        app.UseAuthentication();
        app.UseAuthorization();
    }
}

public class HealthCheckModule : IWebModule
{
    public void Add(WebApplicationBuilder builder)
    {
        builder.Services.AddHealthChecks();
    }

    public void Use(WebApplication app)
    {
        app.MapHealthChecks("/health");
    }
}

Registration

Pass explicit module instances — no reflection, fully AOT-compatible:

builder.AddInfrastructureModules(
    new SwaggerModule(),
    new CorsModule(),
    new AuthModule(),
    new HealthCheckModule()
);

Clean Program.cs

The end result is a minimal Program.cs:

using Shiny;

var builder = WebApplication.CreateBuilder(args);
builder.AddInfrastructureModules(
    new SwaggerModule(),
    new CorsModule(),
    new AuthModule()
);

var app = builder.Build();
app.UseInfrastructureModules();

app.Run();

All the complexity lives in focused, testable module classes instead of a single monolithic startup file.

AI Coding Assistant

Claude Code GitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-extensions@shiny

Coming soon — Copilot plugin install instructions will be added here.

View shiny-extensions Plugin