Xavier 1.0.4

Xavier

Opinionated but customizable API defaults pack for ASP.NET Core.

Xavier bundles common cross-cutting concerns into a simple, one-liner setup — no boilerplate required.

Install

dotnet add package Xavier

Quick Start

Minimal API

using Xavier.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.AddXavier();

var app = builder.Build();
app.UseXavier();
app.MapXavierInfrastructureEndpoints();

app.MapGet("/", () => "Hello World!");
app.Run();

Controllers

using Xavier.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
builder.AddXavier();

var app = builder.Build();
app.UseXavier();
app.MapControllers();
app.MapXavierInfrastructureEndpoints();

app.Run();

What You Get

Framework Support

Unsupported features gracefully no-op (warning logged, no crash).

Configuration

All features are configurable via code or appsettings.json:

{
    "Xavier": {
        "Correlation": {
            "Enabled": true,
            "HeaderName": "X-Correlation-Id"
        },
        "ErrorHandling": {
            "Enabled": true,
            "IncludeExceptionDetails": false
        },
        "HttpLogging": {
            "Enabled": false
        },
        "RateLimiting": {
            "Enabled": false,
            "PermitLimit": 100,
            "WindowSeconds": 60
        },
        "OpenApi": {
            "Enabled": true,
            "DocumentName": "v1"
        },
        "Health": {
            "Enabled": true,
            "LivenessPath": "/health",
            "ReadinessPath": "/ready"
        },
        "Observability": {
            "Enabled": false
        }
    }
}

Or via code:

builder.AddXavier(options =>
{
    options.RateLimiting.Enabled = true;
    options.RateLimiting.PermitLimit = 100;
    options.Observability.Enabled = true;
    options.Observability.ServiceName = "MyApi";
});

Security Defaults

• Exception details hidden in production
• Sensitive headers (Authorization, Cookie) excluded from HTTP logging
• OpenAPI only exposed in Development environment
• Rate limiting available to prevent abuse

Links

• Full Documentation
• Samples
• Changelog
• Issues

License

MIT - Taiizor