How-to Guides

RazorWire lets ASP.NET Core MVC apps update UI by returning Razor fragments from the server instead of building a separate JSON endpoint and client-state rendering loop.

When using RazorWire Turbo Streams to replace or update parts of a page that contain forms, the original Anti-Forgery token hidden input may be lost. To prevent `400 Bad Request` errors on subsequent form submissions, ensure the token is included in your updated HTML.

See browser status pages and production error pages move from local startup policy to a named AppSurface Web behavior contract.

These guidelines apply to all changes made in this repository.

The **AppSurface CLI** is the command-line home for repository-level AppSurface workflows. It is packaged as a .NET tool with the command name `appsurface`.

Explains the OSS license boundary, commercial purchase intent, and package-readiness signals.

The **ForgeTrust.AppSurface.Web** package provides the bootstrapping logic for building ASP.NET Core applications using the AppSurface module system. It sits on top of the compilation concepts defined in `ForgeTrust.AppSurface.Core`.

Modular integration for .NET Aspire distributed applications.

This directory contains libraries and tools for building command-line applications.

AppSurface is putting its release contract in place before the first tagged version. This file explains the contribution rules that feed the public release surface.

Integrations with various dependency injection containers and advanced DI utilities.

.NET Aspire integration for the AppSurface ecosystem.

Caching primitives for AppSurface applications built on top of `Microsoft.Extensions.Caching.Memory`.

Strongly typed configuration primitives for AppSurface applications.

Modular bootstrapping for .NET Console applications using [CliFx](https://github.com/Tyrrrz/CliFx).

The foundation of the AppSurface ecosystem. This package defines the core abstractions, the startup pipeline, and the module system that powers all other AppSurface libraries.

Autofac IoC container integration for AppSurface modules.

Documentation site generation and hosting for AppSurface web applications.

AppSurface host for serving or exporting RazorDocs as an application.

`ForgeTrust.AppSurface.MarkdownSnippets` keeps checked-in Markdown code fences synchronized with source-owned samples. It is intentionally a generator and verifier only: rendered documentation consumes normal Markdown after the generated blocks have been materialized.

This package provides a modular integration for OpenAPI (Swagger) document generation in AppSurface web applications.

This package integrates the [Scalar](https://scalar.com/) API Reference UI into AppSurface web applications.

Tailwind CSS integration for AppSurface web applications with zero Node.js dependency.

Platform-specific runtime packages that carry the official standalone Tailwind CLI binaries used by `ForgeTrust.AppSurface.Web.Tailwind`.

<https://polyformproject.org/licenses/small-business/1.0.0>

RazorDocs should feel like a focused documentation workspace, not a marketing site and not a generic SaaS dashboard. The UI should help people orient quickly, scan densely, and move deeper into docs with very little friction.

This note keeps the in-repo RazorDocs plan aligned with the phased GitHub roadmap.

The **RazorWire CLI** is a command-line tool for managing RazorWire projects. Its primary feature is exporting a reactive RazorWire site into CDN-ready static files by default, with an opt-in hybrid mode for deployments that still provide server routing.

RazorWire helps server-rendered ASP.NET Core apps update page fragments without asking every app to invent a separate frontend runtime. That means RazorWire occasionally owns small generated UI nodes: enhancement markers, form feedback, stream connection affordances, and other package-created fragments that support RazorWire behavior.

AppSurface is pre-`v1.0.0`, but security reports still need a private path.

This directory contains libraries and tools specifically for web application development within the AppSurface ecosystem.