ExperimentFramework.Dashboard 0.23.4

ExperimentFramework.Dashboard

Enterprise-grade, embeddable web dashboard for managing A/B tests, feature flags, and experiments in .NET applications.

Features

• Experiment Management: Create, configure, and manage experiments with an intuitive web UI
• Analytics Dashboard: Visualize experiment performance and statistical analysis
• Governance Workflows: Approval workflows, lifecycle management, versioning, and audit trails
• Rollout Management: Gradual rollout with stage-based deployment
• Targeting Rules: Advanced user targeting and segmentation
• Configuration DSL: YAML-based configuration with Monaco editor
• Plugin System: Discover and manage experiment plugins
• Multi-Tenancy: Built-in support for multi-tenant scenarios via ITenantResolver
• Authorization: Delegates to ASP.NET Core authorization (no user management)

Installation

dotnet add package ExperimentFramework.Dashboard

Quick Start

1. Add Dashboard Services

using ExperimentFramework.Dashboard;

var builder = WebApplication.CreateBuilder(args);

// Configure dashboard
builder.Services.AddExperimentDashboard(options =>
{
 options.PathBase = "/dashboard";
 options.Title = "My Experiments";
 options.EnableAnalytics = true;
 options.EnableGovernanceUI = true;
});

2. Map Dashboard Endpoint

var app = builder.Build();

// Map dashboard at /dashboard
app.MapExperimentDashboard("/dashboard");

app.Run();

3. Access Dashboard

Navigate to https://localhost:5001/dashboard to access the dashboard.

Configuration Options

builder.Services.AddExperimentDashboard(options =>
{
 // Basic settings
 options.PathBase = "/dashboard";
 options.Title = "Experiment Dashboard";
 options.ItemsPerPage = 25;

 // Features
 options.EnableAnalytics = true;
 options.EnableGovernanceUI = true;

 // Authorization
 options.RequireAuthorization = true;
 options.AuthorizationPolicy = "DashboardAccess";

 // Multi-tenancy
 options.TenantResolver = new HttpHeaderTenantResolver("X-Tenant-Id");
});

Multi-Tenancy

Configure tenant resolution using built-in or custom resolvers:

// HTTP Header
options.TenantResolver = new HttpHeaderTenantResolver("X-Tenant-Id");

// Subdomain
options.TenantResolver = new SubdomainTenantResolver();

// Claims
options.TenantResolver = new ClaimTenantResolver("tenant_id");

// Composite (try multiple strategies)
options.TenantResolver = new CompositeTenantResolver(
 new ClaimTenantResolver("tenant_id"),
 new HttpHeaderTenantResolver("X-Tenant-Id")
);

Authorization

The dashboard delegates authorization to your existing ASP.NET Core setup:

// Configure authorization
builder.Services.AddAuthorization(options =>
{
 options.AddPolicy("DashboardAccess", policy =>
 {
 policy.RequireAuthenticatedUser();
 policy.RequireRole("Admin", "Experimenter");
 });
});

// Enable in dashboard
builder.Services.AddExperimentDashboard(options =>
{
 options.RequireAuthorization = true;
 options.AuthorizationPolicy = "DashboardAccess";
});

// Use authentication middleware
app.UseAuthentication();
app.UseAuthorization();

Extensibility

Custom Tenant Resolver

public class CustomTenantResolver : ITenantResolver
{
 public Task<TenantContext?> ResolveAsync(HttpContext context)
 {
 // Your custom logic
 var tenantId = /* ... */;

 return Task.FromResult(new TenantContext
 {
 TenantId = tenantId,
 DisplayName = "My Tenant",
 Environment = "Production"
 });
 }
}

Custom Data Provider

public class CustomDataProvider : IDashboardDataProvider
{
 public Task<IEnumerable<ExperimentInfo>> GetExperimentsAsync(
 string? tenantId,
 CancellationToken ct = default)
 {
 // Your custom data access logic
 }
}

// Register
builder.Services.AddSingleton<IDashboardDataProvider, CustomDataProvider>();

API Endpoints

The dashboard exposes REST APIs at /dashboard/api:

• GET /api/experiments - List all experiments
• GET /api/experiments/{name} - Get experiment details
• POST /api/experiments/{name}/toggle - Toggle experiment active state
• GET /api/configuration/yaml - Export configuration as YAML
• GET /api/governance/{name}/state - Get governance state
• GET /api/analytics/{name}/statistics - Get statistical analysis
• GET /api/rollout/{name}/stages - Get rollout stages
• GET /api/targeting/{name}/rules - Get targeting rules

Requirements

• .NET 10.0 or later
• ASP.NET Core
• ExperimentFramework package

License

MIT

Links

• GitHub Repository
• Documentation
• Sample Application