Pluggable foundation blocks for building loosely coupled distributed apps.

• 🔌 Pluggable implementations - Swap Redis, Azure, AWS, or in-memory with no code changes
• 🧪 Developer friendly - In-memory implementations for fast local development and testing
• 💉 DI native - Built for Microsoft.Extensions.DependencyInjection
• 🎯 Interface-first - Code against abstractions, not implementations
• ⚡ Production ready - Battle-tested in high-scale applications
• 🔄 Consistent APIs - Same patterns across caching, queues, storage, and more

dotnet add package Foundatio

// Caching
ICacheClient cache = new InMemoryCacheClient();
await cache.SetAsync("user:123", user, TimeSpan.FromMinutes(5));
var cached = await cache.GetAsync<User>("user:123");

// Queuing
IQueue<WorkItem> queue = new InMemoryQueue<WorkItem>();
await queue.EnqueueAsync(new WorkItem { Data = "Hello" });
var entry = await queue.DequeueAsync();

// File Storage
IFileStorage storage = new InMemoryFileStorage();
await storage.SaveFileAsync("docs/readme.txt", "Hello World");

// Distributed Locks
ILockProvider locker = new CacheLockProvider(cache, messageBus);
await using var handle = await locker.AcquireAsync("resource-key");

👉 Complete Documentation

Key topics:

• Getting Started - Installation and setup
• Caching - Cache implementations and patterns
• Queues - Message queue processing
• Jobs - Background job execution
• Configuration - Options and settings

Want the latest CI build before it hits NuGet? Add the Feedz source and install the pre-release version:

dotnet nuget add source https://f.feedz.io/foundatio/foundatio/nuget -n foundatio-feedz
dotnet add package Foundatio --prerelease

Or add to your NuGet.config:

<configuration>
  <packageSources>
    <add key="foundatio-feedz" value="https://f.feedz.io/foundatio/foundatio/nuget" />
  </packageSources>
  <packageSourceMapping>
    <packageSource key="foundatio-feedz">
      <package pattern="Foundatio.*" />
    </packageSource>
  </packageSourceMapping>
</configuration>

Contributions are welcome! Please feel free to submit a Pull Request. See our documentation for development guidelines.

Development Setup:

1. Clone the repository
2. Open Foundatio.slnx in Visual Studio or VS Code
3. Run dotnet build to build
4. Run dotnet test to run tests

• Foundatio.Mediator - Blazingly fast, convention-based C# mediator powered by source generators

Apache 2.0 License