Examples
Source of truth
This directory contains sample applications that use ForgeTrust.AppSurface.
- Auth ASP.NET Core bridge example – proves an ASP.NET Core host-owned auth stack can flow named policy results into AppSurface auth contracts.
- Auth Aspire Keycloak AppHost proof – starts real local Keycloak for AppSurface OIDC proof without making runtime web apps reference Keycloak packages.
- Auth Web/RazorWire proof – shows a browser-first proof that one ASP.NET Core policy drives both a Minimal API response and a RazorWire-facing state.
- Aspire AppHost example – shows local Aspire AppHost composition with AppSurface profiles and reusable Aspire components.
- Console app example – shows how to build a simple console application using CliFx for command definitions.
- LocalSecrets example – shows how to set one local development secret, resolve it through AppSurface Config, and inspect diagnostics without printing the value.
- Web app example – demonstrates starting a minimal ASP.NET Core web application.
- Web error-page proof – verifies AppSurface Web browser status pages, production exception pages, and API-friendly non-HTML behavior.
- Web PWA worker proof – shows AppSurface Web install metadata, combined offline and push-worker behavior, explicit browser registration, development diagnostics, and CLI verification.
- Config validation example – shows scalar validation on a strongly typed config wrapper and the startup failure shape.
- Flow approval local example – shows a typed flow that waits for an approval event and resumes through the in-memory runner.
- Flow generated authoring example – shows generated outcome cases, typed input/output ports, inferred and explicit graph mapping, and generated lowering into the in-memory runner.
- Product readiness lab – runs a report-first local evaluator that composes AppSurface Web, Auth.AspNetCore, Flow, DurableTask-facing host-shape guidance, Aspire, and Postgres product-state proof. Its paired AppHost
verifyprofile starts local Postgres and requires the product-state row to becomeproven-locally.