Claimly BFF

A .NET 9 solution using Backend-for-Frontend pattern with Blazor WebAssembly, FastEndpoints API, and PostgreSQL.

Architecture

Quick Start

# Run entire application stack (recommended)
dotnet run --project src/Aspire/AppHost/HeadStart.Aspire.AppHost.csproj

Tech Stack

• Frontend: Blazor WebAssembly + MudBlazor + Tailwind CSS
• Backend: ASP.NET Core BFF + FastEndpoints API
• Database: PostgreSQL with Entity Framework Core
• Auth: OpenID Connect (Keycloak) + OpenIddict
• Infrastructure: .NET Aspire orchestration + YARP reverse proxy

Architecture

BFF serves the Blazor client and proxies API calls with automatic token forwarding. WebAPI uses FastEndpoints for clean endpoint organization. Aspire handles service discovery and orchestration.

E2E Testing Setup

Install Playwright CLI

dotnet tool install --global Microsoft.Playwright.CLI

# Add to PATH (choose based on your OS)
# macOS/Linux:
export PATH="$PATH:$HOME/.dotnet/tools"
# Windows (PowerShell):
$env:PATH += ";$env:USERPROFILE\.dotnet\tools"

# Verify installation
playwright

# Install browsers (required for test execution)
playwright install

API Client Generation

To generate the API clients, run the following command:

dotnet run --generateclients true --project src/WebAPI/HeadStart.WebAPI.csproj