Installation

Prerequisites

• .NET 10 SDK or later
• An IDE with C# support (VS 2022, Rider, VS Code)

Quick Setup

1. Add the NuGet packages

Start with the modules you need:

# Core (always needed)
dotnet add package Pragmatic.Result
dotnet add package Pragmatic.Ensure

# Pick what you need
dotnet add package Pragmatic.Endpoints
dotnet add package Pragmatic.Actions
dotnet add package Pragmatic.Persistence.EFCore
dotnet add package Pragmatic.Validation
dotnet add package Pragmatic.Mapping

2. Add the Source Generator

<ProjectReference Include="path/to/Pragmatic.SourceGenerator.csproj"
                  OutputItemType="Analyzer"
                  ReferenceOutputAssembly="false" />

Or via NuGet (when published):

dotnet add package Pragmatic.SourceGenerator

3. Build and go

dotnet build

The Source Generator automatically detects which Pragmatic modules are referenced and generates the appropriate code. No configuration needed.

What Gets Generated

The generator scans your referenced assemblies and produces code based on what it finds:

If you reference…	The generator produces…
Pragmatic.Endpoints	Endpoint registration, request binding
Pragmatic.Actions	Action invokers, DI wiring
Pragmatic.Persistence.EFCore	Repositories, entity configs, query filters
Pragmatic.Validation	Validator registration
Pragmatic.Mapping	Mapping extension methods
Pragmatic.Composition	Startup step orchestration

Verify Installation

After building, check the obj/ folder for generated files:

obj/Debug/net10.0/generated/
└── Pragmatic.SourceGenerator/
    ├── PlaceOrder.Invoker.g.cs
    ├── GetProductEndpoint.Handler.g.cs
    └── ...

Next Steps

• Architecture — How modules compose together
• Endpoints — Build your first endpoint