👁 Image
Foundatio.JsonNet 13.0.1

👁 Foundatio
👁 Foundatio

👁 Build status
👁 NuGet Version
👁 feedz.io
👁 Discord

Pluggable foundation blocks for building loosely coupled distributed apps.

✨ Why Choose Foundatio?

• 🔌 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

🧱 Core Building Blocks

🚀 Quick Start

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");

📦 Provider Implementations

📚 Learn More

👉 Complete Documentation

Core Features

• Getting Started - Installation and setup
• Caching - In-memory, Redis, and hybrid caching with invalidation
• Queues - FIFO message delivery with lock renewal and retry policies
• Locks - Distributed locking with null handling patterns
• Messaging - Pub/sub with size limits and notification patterns
• File Storage - Unified file API across providers
• Jobs - Background job processing and hosted service integration

Advanced Topics

• Resilience - Retry policies, circuit breakers, and timeouts
• Serialization - Serializer configuration and performance
• Dependency Injection - DI setup and patterns
• Configuration - Options and settings

📦 CI Packages (Feedz)

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>

🤝 Contributing

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

🔗 Related Projects

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

📄 License

Apache 2.0 License

Thanks to all the people who have contributed