gaelic-ghost/socket/build-giraffe-web-app

Build Giraffe Web App

Use Giraffe's functional handler composition as the HTTP boundary, not as a reason to place business rules in route declarations.

Source Check

Inspect the existing host, package lock or project references, handlers, tests, and configuration first. Use the Giraffe documentation and ASP.NET Core documentation when repository evidence is insufficient.

Workflow

1. Confirm that Giraffe is already selected; otherwise use

dotnet:choose-fsharp-web-framework first.

1. Keep request parsing, authentication context, and response writing in narrow

HttpHandler functions. Compose reusable HTTP concerns with >=> only when they have one clear request-pipeline responsibility.

1. Put domain transformations and external-dependency contracts in separately

testable F# modules. Pass dependencies explicitly or resolve genuine host dependencies at a clear ASP.NET Core boundary.

1. Preserve ASP.NET Core ordering: routing, authentication, authorization,

static files, exception handling, and Giraffe middleware must remain aligned with the application's existing host contract.

1. Make response errors specific: route, failed input or dependency, and the

safe client-facing outcome. Do not leak secrets or internal exception details.

1. Test pure domain behavior first, then handler or host behavior for route,

authorization, binding, status, and response regressions.

Validation

Use the narrowest project commands available, normally:

dotnet build <web-project.fsproj>
dotnet test <test-project.fsproj>

Do not run a live deployment or add a replacement middleware stack merely to exercise one handler.

Boundaries

• Keep .fsproj file order valid as modules are added.
• Use ordinary ASP.NET Core middleware and services when that is the existing

integration surface; do not reimplement them as Giraffe helpers.

• Route Azure hosting, identity, resource configuration, and deployment work to

the official Azure Skills plugin through cloud-deployment-routing-workflow.