Wayfinder 0.7.3

.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.7.3
                    


                    

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


                            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.7.3
                    


                    

                
#r "nuget: Wayfinder, 0.7.3"
#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.7.3
#: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.7.3
                    


                            Install as a Cake Addin
                        

                    

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


                            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 (3)

Showing the top 3 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). Reusable by any .NET host building its own blueprint-driven business app; Umbraco Prism is one such consumer, not a dependency.
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.9.4 504 9/7/2026
0.9.3 108 9/7/2026
0.9.2 197 9/6/2026
0.9.1 231 9/5/2026
0.9.0 89 9/5/2026
0.8.1 186 9/2/2026
0.8.0 111 9/2/2026
0.7.9 166 8/30/2026
0.7.8 159 8/28/2026
0.7.7 297 8/28/2026
0.7.6 181 8/24/2026
0.7.5 215 8/21/2026
0.7.4 163 8/21/2026
0.7.3 132 8/21/2026
0.7.2 167 8/20/2026
0.7.1 179 8/20/2026
0.7.0 207 8/19/2026
0.6.0 142 8/17/2026
0.4.10 138 8/12/2026
0.4.9 133 8/10/2026
Loading failed