🚀 Fluent Framework

A modern collection of libraries for .NET applications.

Build better .NET applications with fluent, expressive APIs across HTTP, UI, and more.

Created with ❤️ in Poland by Leszek Pomianowski and open-source community.

---

📦 Packages

Fluent Framework is a collection of independent packages. Use what you need.

Package	Description	NuGet
Fluent.Client	Fluent HTTP client wrapper for clean, chainable requests
Fluent.Client.AwesomeAssertions	Expressive HTTP response assertions for integration tests

Note

More packages coming soon. Stay tuned!

---

⚡ Quick Start

HTTP Client

dotnet add package Fluent.Client

using Fluent.Client;

var client = new HttpClient { BaseAddress = new Uri("https://api.example.com/") };

// Clean, fluent HTTP requests
var response = await client
    .Authorize(token: "jwt-token")
    .Post("/api/users", new { Name = "John" });

Testing Assertions

dotnet add package Fluent.Client.AwesomeAssertions

using Fluent.Client.AwesomeAssertions;

// Expressive test assertions
await client
    .Post("/api/users", new { Name = "John" })
    .Should()
    .Succeed("because valid data was provided");

---

🎯 Philosophy

Fluent Framework follows these principles:

Principle	Description
🧩 Modular	Use only what you need. Each package is independent.
📖 Readable	APIs designed to read like natural language.
🔧 Extensible	Easy to extend and customize for your needs.
✅ Testable	Built with testing in mind from the ground up.
🚀 Modern	Targets latest .NET with modern C# features.

---

🛠️ Building from Source

Prerequisites

• .NET 10 SDK or later
• Visual Studio 2022, VS Code, or JetBrains Rider

Build

git clone https://github.com/lepoco/fluent.git
cd fluent
dotnet build

Run Tests

dotnet test

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Ways to Contribute

• 🐛 Report bugs and issues
• 💡 Suggest new features or packages
• 📝 Improve documentation
• 🔧 Submit pull requests

---

👥 Maintainers

• Leszek Pomianowski (@pomianowski)

---

💬 Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

---

📄 License

This project is licensed under the MIT license. See the LICENSE file for details.

You can use it in private and commercial projects. Keep in mind that you must include a copy of the license in your project.