UnambitiousFx Documentation

UnambitiousFx is a set of small, focused .NET libraries for building explicit, composable application flows with minimal runtime overhead.

This page is the documentation nexus: start here, then jump directly to the library or topic you need.

Choose a Library

Functional

Functional primitives for predictable control flow:

• Result and Result<T> for explicit success/failure
• Maybe<T> for optional values without null noise
• composable operations like Map, Bind, Ensure, Recover, and Tap

Start here:

• Functional docs
• Result guide
• Maybe guide
• Failures and Metadata
• ASP.NET Core integration

Synapse (work in progress)

Lightweight in-process messaging primitives (commands, queries, events, pipelines, streaming).

Start here:

• Synapse docs
• Synapse source on GitHub

Quick Install

Install only the packages you need:

# Core functional primitives
dotnet add package UnambitiousFx.Functional

# ASP.NET Core integration
dotnet add package UnambitiousFx.Functional.AspNetCore

# xUnit assertions
dotnet add package UnambitiousFx.Functional.xunit

For all UnambitiousFx libraries:

• See Package Feeds for stable and pre-release package sources, including custom feed setup.

Navigate by Goal

Goal	Go to
Model success/failure without exceptions	Result
Represent optional values cleanly	Maybe
Standardize error contracts and metadata	Failures and Metadata
Return HTTP responses from domain results	ASP.NET Core integration
Add fluent assertions in tests	xUnit integration
Explore mediator-style app flows	Synapse docs

Recommended Reading Order

1. Functional overview
2. Result
3. Maybe
4. Failures and Metadata
5. ASP.NET Core integration
6. Synapse docs