# Synapse - UnambitiousFx

> Synapse is a simple Native-AOT mediator

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [Synapse](https://synapse.unambitiousfx.com/docs/): Lightweight, Native-AOT-ready in-process mediator for .NET. Commands, Queries, Events, and composable Pipelines with zero runtime reflection.
- [Getting Started](https://synapse.unambitiousfx.com/docs/getting-started): Install Synapse, wire it up in a .NET application, and send your first command end-to-end.
- [Commands and Queries](https://synapse.unambitiousfx.com/docs/commands-and-queries): Model operations as Commands and Queries using IRequest, IRequestHandler, and IInvoker — the core request/response primitive in Synapse.
- [Events](https://synapse.unambitiousfx.com/docs/events): Fan-out in-process event publishing with IEmitter, IEventHandler, and sequential or concurrent orchestration.
- [Pipeline Behaviors](https://synapse.unambitiousfx.com/docs/pipelines): Wrap request, event, or stream handling with cross-cutting logic using the chain-of-responsibility pipeline pattern.
- [ASP.NET Core Integration](https://synapse.unambitiousfx.com/docs/aspnetcore): IHttpInvoker, IMvcInvoker, and UseCorrelationId middleware for translating Results to HTTP responses with zero mapping boilerplate.
- [Benchmarks](https://synapse.unambitiousfx.com/docs/benchmarks): Performance and allocation comparison of Synapse against MediatR and martinothamar/Mediator across send, publish, and pipeline scenarios.
- [Changelog](https://synapse.unambitiousfx.com/docs/changelog): Resolved issues and hardening fixes found during development of Synapse on the feature/typed-pipeline-behaviors branch.
- [Context](https://synapse.unambitiousfx.com/docs/context): Per-DI-scope correlation ID, metadata bag, and extensible feature system that flows through every handler and pipeline behavior.
- [Error Handling](https://synapse.unambitiousfx.com/docs/error-handling): Work with Result and Result of T across handlers, pipelines, and call sites — errors as values, not exceptions.
- [Examples](https://synapse.unambitiousfx.com/docs/examples): Runnable example projects that demonstrate Synapse features in context, with links to source code.
- [Observability](https://synapse.unambitiousfx.com/docs/observability): Structured logging, distributed tracing (ActivitySource), OpenTelemetry metrics, and outbox health checks for Synapse.
- [Outbox Pattern](https://synapse.unambitiousfx.com/docs/outbox): Defer event dispatch until after your transaction commits using the built-in outbox, with retry, dead-lettering, and health checks.
- [Source Generator](https://synapse.unambitiousfx.com/docs/source-generator): Roslyn incremental source generator that eliminates manual handler registration and enables NativeAOT-safe dispatch.
- [Streaming](https://synapse.unambitiousfx.com/docs/streaming): Yield results one item at a time via IAsyncEnumerable using IStreamRequest and IStreamRequestHandler.
- [Using these docs with AI](https://synapse.unambitiousfx.com/docs/using-with-ai): Point Claude, Cursor, Copilot and other AI assistants at the Synapse docs via llms.txt and the Context7 MCP server.
- [Validation](https://synapse.unambitiousfx.com/docs/validation): Run validators before the handler is invoked using IRequestValidator and the built-in RequestValidationBehavior pipeline stage.