Koan.Web 0.5.2

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher. 
dotnet add package Koan.Web --version 0.5.2
                    


                    

                
NuGet\Install-Package Koan.Web -Version 0.5.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Koan.Web" Version="0.5.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Koan.Web" Version="0.5.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Koan.Web" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Koan.Web --version 0.5.2
                    


                    

                
#r "nuget: Koan.Web, 0.5.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Koan.Web@0.5.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Koan.Web&version=0.5.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Koan.Web&version=0.5.2
                    


                            Install as a Cake Tool

Sylin.Koan.Web

ASP.NET Core integration for Koan: controller-first routing, health endpoints, well-known endpoints, and observability bootstrap.

  • Target framework: net9.0
  • License: Apache-2.0

Capabilities

  • MVC controller-first routing (attribute-routed)
  • Health endpoints and OpenAPI wiring (opt-in)
  • Transformers for payload shaping (see WEB-0035)

Install (minimal setup)

dotnet add package Sylin.Koan.Web

Usage — quick examples

  • Expose REST endpoints via controllers, not inline endpoints:
public sealed class ItemsController : EntityController<Item, Guid>
{
	// GET /api/items
	[HttpGet("api/items")]
	public async Task<IActionResult> GetAll(CancellationToken ct)
		=> Ok(await Item.FirstPage(50, ct));
}
  • Use transformers for response shaping; see decision WEB-0035.

See TECHNICAL.md for contracts, options, and integration details.

Customization

  • Configuration and advanced usage are documented in TECHNICAL.md.

References

  • Web API conventions: /docs/api/web-http-api.md
  • Decision: /docs/decisions/WEB-0035-entitycontroller-transformers.md
  • Engineering guardrails: /docs/engineering/index.md
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (7)

Showing the top 5 NuGet packages that depend on Koan.Web:

Package Downloads
Koan.Media.Core

Media core for Koan: Ensure, pipelines, ancestry, and URL helpers over Koan.Storage.
Koan.Web.Extensions

Web capability extensions (moderation, soft-delete, audit) for Koan applications.
Koan.Web.Transformers

HTTP payload transformers for Koan Web: flexible request/response shaping with auto-discovery.
Koan.Recipe.Observability

Observability baseline recipe (health checks + OTEL + resilient HttpClient).
Koan.Web.GraphQl

Koan GraphQL module providing a controller-hosted GraphQL endpoint and schema for IEntity<> types.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.5.2 195 9/16/2025

See release notes: https://github.com/sylin-labs/Koan-framework/releases