Wayfinder 0.4.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Wayfinder --version 0.4.2
                    


                    

                
NuGet\Install-Package Wayfinder -Version 0.4.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="Wayfinder" Version="0.4.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Wayfinder" Version="0.4.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Wayfinder" />
                    


                            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 Wayfinder --version 0.4.2
                    


                    

                
#r "nuget: Wayfinder, 0.4.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 Wayfinder@0.4.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=Wayfinder&version=0.4.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Wayfinder&version=0.4.2
                    


                            Install as a Cake Tool

<picture> <source media="(prefers-color-scheme: dark)" srcset="assets/wordmark-dark.png"> <img src="assets/wordmark-light.png" alt="Wayfinder" height="56"> </picture>

CI Wayfinder Wayfinder.Engine Wayfinder.Editor License: MIT

A GDS-style service blueprint / service-design engine — domain model, calculation engine, state-machine engine, and a compiled visual editor web component. Framework-agnostic: no Umbraco, no ASP.NET Core MVC, no hosting assumptions baked in.

Wayfinder was extracted from Umbraco Prism, which is now a consumer of these packages rather than their owner. A host application — Umbraco-based or otherwise — layers its own tenancy, auth, and rendering opinions on top. Wayfinder.Umbraco is the Umbraco-hosted implementation Prism itself uses.

See it running

Wayfinder.AppHost + Wayfinder.ReferenceApp is a small, self-contained .NET Aspire host in this repo — every package wired together, real GOV.UK Design System rendering, a demo login, and a seeded "apply for a licence to hold a juggling event" journey. It's the fastest way to see what a working Wayfinder host actually looks like, and exactly how little wiring a real host (like Wayfinder.Umbraco) collapses into. Run it with dotnet run --project Wayfinder.AppHost, or the "C#: Aspire (Full Stack)" launch config in VS Code. See docs/guides/reference-app.md for what it implements, how the demo blueprint is seeded from JSON and only saved in memory, and what a real host does differently.

Packages

Package Purpose
Wayfinder Core domain models (ServiceBlueprint, ServiceRequestResponseEnvelope, etc.), the declarative calculation engine, and the sanitizer interface. Zero framework dependency.
Wayfinder.Engine The service blueprint state-machine engine — queue routing, gateway evaluation, request persistence.
Wayfinder.Engine.Api REST toolkit (MapServiceBlueprintAuthoringApi()) exposing service blueprint authoring — list/read/validate/save/simulate — over HTTP for any ASP.NET Core host.
Wayfinder.Engine.Mcp MCP-over-HTTP toolkit (MapServiceBlueprintAuthoringMcp()) — the same authoring surface as MCP tools for AI agents.

The service blueprint model

A ServiceBlueprint describes a journey as queues (named work queues), stages (each owning its own routes), and gateways (first-class Split/Join routing nodes — a stage's routes must always target a gateway, never another stage directly). See docs/guides/reference-service-blueprint-contract.md for the full authoring schema, and docs/guides/calculation-language.md for the declarative expression language used in calculations and showWhen.

AI-ready authoring

Service blueprint authoring is exposed to AI agents (Claude Code or any MCP client) the same way it's exposed to a human editor: as a toolkit a host app wires into its own pipeline. Wayfinder.Engine.Api and Wayfinder.Engine.Mcp map the same list/read/validate/save/simulate operations as REST and MCP-over-HTTP respectively, both calling straight into a host's live Wayfinder.Engine in-process. See docs/guides/ai-service-blueprint-authoring.md.

Building

dotnet build Wayfinder.slnx
dotnet pack Wayfinder.slnx

License

MIT — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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.

  • net10.0

    • No dependencies.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Wayfinder:

Package Downloads
Wayfinder.Engine

Umbraco/Umbraco.Cms-independent GDS-style blueprint state-machine engine (queue routing, gateway evaluation, instance persistence) used by Umbraco Prism. Reusable by any .NET host building its own blueprint-driven business app.
UmbracoPrism

Multi-tenancy for Umbraco (v17+) with dynamic branding and stateless identity.
Wayfinder.Umbraco

Umbraco-hosted implementation of Wayfinder service design — a DB-backed, uSync-portable service blueprint store, a backoffice authoring API, and two Block Grid-composable building blocks (a citizen-facing stage journey and a caseworker-facing worklist) for any Umbraco v17+ site. An authoritative in-process engine, real multi-queue support, no multi-tenancy or auth opinions of its own; a host wires its own identity/tenant resolution on top.
Wayfinder.Rendering.GovUk

Default GOV.UK Design System rendering for Wayfinder's Component/FieldRenderPayload catalog — plain C#, no Razor/ASP.NET Core MVC dependency, so it works from a minimal-API host as well as an MVC one. Ships one function per component/field type, plus a small override registry for hosts that want to replace or extend individual types. Also ships GovUkStageJourney — the blueprint-agnostic glue (form-body rendering, file-download/bulk-dataset URL injection, posted-form field coercion) every host route rendering a stage otherwise hand-copies. Also ships the real vendored govuk-frontend package itself, the CSS/JS the slider/stat-group/chart/live-form markup needs (no GOV.UK Design System equivalent exists for these), and the poll/init boilerplate every host otherwise re-writes — all as static web assets at /_content/Wayfinder.Rendering.GovUk/, version-locked to what this package's own generated markup actually targets, so every host loads the same files instead of hand-copying its own.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.7.6 139 8/24/2026
0.7.5 177 8/21/2026
0.7.4 143 8/21/2026
0.7.3 118 8/21/2026
0.7.2 147 8/20/2026
0.7.1 162 8/20/2026
0.7.0 177 8/19/2026
0.6.0 132 8/17/2026
0.4.10 128 8/12/2026
0.4.9 120 8/10/2026
0.4.8 145 8/9/2026
0.4.7 124 8/9/2026
0.4.6 196 8/5/2026
0.4.5 168 8/4/2026
0.4.4 189 8/4/2026
0.4.3 166 8/4/2026
0.4.2 141 8/4/2026
0.4.1 172 8/3/2026
0.4.0 139 8/3/2026
0.3.0 154 8/2/2026
Loading failed