Section

Examples

Inspect concrete, working proof that shows the system behaving in practice.

Start Here Docs home

In this section

Browse the public pages here.

RazorWire MVC Example Example

This sample is the concrete proof behind the RazorWire package README. It shows how returned Razor fragments, islands, and SSE fit into a normal ASP.NET Core MVC app without a separate client rendering stack.
AppSurface ASP.NET Core DevAuth Example Example

This example proves `ForgeTrust.AppSurface.Auth.AspNetCore.DevAuth` can give a local package consumer a fake, visible persona lab without configuring an external identity provider. DevAuth activates only in `Development` by default and can opt in additional local/proof environments through `AllowedEnvironmentNames`.
AppSurface Auth ASP.NET Core Bridge Example Example

This example proves `ForgeTrust.AppSurface.Auth.AspNetCore` can consume a normal ASP.NET Core authentication and authorization setup without owning it.
AppSurface Auth ASP.NET Core OIDC Example Example

This example proves `ForgeTrust.AppSurface.Auth.AspNetCore.Oidc` can register named cookie and OIDC schemes without owning host defaults or requiring a live identity provider for local diagnostics.
AppSurface Auth Aspire Keycloak AppHost Example

This AppHost proves `ForgeTrust.AppSurface.Auth.Aspire.Keycloak` with real local Keycloak and a paired ASP.NET Core web app that uses `ForgeTrust.AppSurface.Auth.AspNetCore.Oidc`.
AppSurface Auth Aspire Keycloak Verifier Example

This helper is run by the `verify` profile in `examples/auth-aspire-keycloak-apphost`. It probes the AppHost-backed web app and checks generated realm evidence. Run it through the AppHost rather than directly:
AppSurface Auth Aspire Keycloak Web Proof Example

This web app uses `ForgeTrust.AppSurface.Auth.AspNetCore.Oidc` directly. It does not reference `ForgeTrust.AppSurface.Auth.Aspire.Keycloak`; the AppHost package only supplies local provider configuration.
AppSurface Auth Web/RazorWire Proof Example

This sample is the five-minute proof for `ForgeTrust.AppSurface.Auth.AspNetCore` plus `ForgeTrust.RazorWire.Auth.AspNetCore`: one host-owned ASP.NET Core policy flows through AppSurface into a Minimal API response and RazorWire auth projection markup.
AppSurface Flow Approval Example Example

This example shows the first local-development path for AppSurface Flow: define a typed graph, run until a wait, then resume the same node with an external event.
AppSurface Flow Generated Authoring Example Example

This example shows the generated-authoring path for AppSurface Flow. The app defines a partial flow specification with `[FlowAuthoring]`, typed input and output ports, generated outcome cases, a generated envelope context, a generated graph mapping helper, and generated adapters that lower into the existing in-memory runner.
AppSurface Product Readiness Lab Example

This example is a local evaluator for AppSurface package-family adoption. The readiness report is the product; the small SaaS-shaped app exists to generate evidence.
AppSurface Web PWA Worker Foundation Proof Example

This example shows the AppSurface Web install, offline, and push-worker foundation without adding a separate package. Its explicit registration button proves browser worker activation while deliberately leaving notification permission, push subscription, and delivery unconfigured.
Aspire AppHost Example Example

This example proves the local `ForgeTrust.AppSurface.Aspire` adoption path. It starts an Aspire AppHost through `AspireApp<TModule>`, selects a profile command with CliFx, and composes the existing web example through reusable Aspire components. The web example registers `ForgeTrust.AppSurface.Observability`, so Aspire-provided OTLP configuration flows into the app-side OpenTelemetry logging, tracing, and metrics setup.
Config validation example Example

This sample shows scalar validation on a strongly typed AppSurface config wrapper.
Console app example Example

This sample demonstrates how to build a console application with **ForgeTrust.AppSurface**.
Examples Example

This directory contains sample applications that use **ForgeTrust.AppSurface**.
LocalSecrets example Example

This sample shows the complete local-secret workflow without printing the secret value.
Product Readiness Lab AppHost Example

This AppHost runs `examples/product-readiness-lab` with a local Postgres resource for product/domain state.
Web app example Example

This example shows how to build a minimal ASP.NET Core application using **ForgeTrust.AppSurface.Web**.
Web error-page proof Example

This example is a confidence proof for the `ForgeTrust.AppSurface.Web` error-page conventions. It does not add new framework behavior. It runs a small app and verifies that browser users get conventional HTML status and exception pages while API clients avoid surprise browser HTML.