Examples

This directory contains sample applications that use ForgeTrust.AppSurface.

• RazorWire brochure starter – a package-only MVC field-notes site that proves the smallest practical RazorWire and static-export path without source project references, Tailwind, or a delivery endpoint.
• 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 ASP.NET Core DevAuth example – retains the responsive selectable persona marker and pairs an in-process host regression with a staged real-loopback verifier that distinguishes build, child-process, Kestrel-readiness, and DevAuth HTTP failures while retaining only bounded safe evidence.
• Auth Aspire Keycloak AppHost proof – starts real local Keycloak for AppSurface OIDC proof without making runtime web apps reference Keycloak packages, including a finite #782 completion-gate feasibility spike before the web proof starts.
• 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.
• Native Aspire deployment example – publishes deterministic GCP migration-job artifacts and exposes read-only parity through native Aspire pipeline commands.
• 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.
• Remote-to-local secret materialization guide – shows how an IAM-authorized developer can clone one pinned Google Secret Manager version into a named local namespace for integration testing without exposing it to the terminal.
• 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.
• Tenant theme selection proof – demonstrates host-owned selection of sealed theme pairs from already-authorized context and why tenant cache isolation cannot use a reusable pair id.
• Web PWA runtime foundation proof – demonstrates AppSurface Web install metadata, independent accessible application badging, combined offline and push-worker behavior, explicit browser registration, optional protected Web Push subscription and sender proof, server-known push-readiness posture, 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.
• Durable PostgreSQL proof – exercises the public-preview provider, ordered schema and epoch setup, Work/Flow/Schedule boundaries, and explicit worker-host opt-in locally; it is a proof surface, not production operations guidance.
• 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 verify profile starts local Postgres and requires the product-state row to become proven-locally.

🏠 Back to Root