UA.Tenet.Web extends the Tenet Framework for ASP.NET Core applications. It provides a unified convention-based configuration combining the structure of Controller-based APIs with the performance of Minimal APIs, along with TagHelpers, view components, and web extensions.
Get Started
$ dotnet add package UA.Tenet.WebReadme
UA.Tenet.Web
UA.Tenet.Web extends the Tenet Framework for ASP.NET Core applications, providing a unified convention-based configuration that combines the structured approach of Controller-based APIs with the simplicity and performance of Minimal APIs.
Features
🚀 Minimal API Extensions
- TenetMinimalAttribute: Convention-based minimal API endpoint registration
- Automatic Route Discovery: Scan and register minimal endpoints automatically
- Endpoint Route Builder Extensions: Simplified endpoint configuration
🎛️ Controllers & Views
- ViewController: Base class for view-focused controllers
- ViewComponentBase: Enhanced view component functionality
- ActionExecutingContext Extensions: Request pipeline utilities
🏷️ Tag Helpers
- TenetImageTagHelper: Enhanced image tag with lazy loading, responsive images, and optimization
- Custom tag helpers for common web scenarios
🔧 Configuration & Middleware
- TenetWebOptions: Centralized web application configuration
- ApplicationBuilder Extensions: Fluent middleware configuration
- ServiceCollection Extensions: Dependency injection setup for web components
📝 Razor Extensions
- RazorPageBase Extensions: Enhanced Razor page functionality
- Helpers for common web development tasks
🌐 HTTP Request Extensions
- Request parsing and validation utilities
- Header and query string manipulation
- Context-aware helpers
Installation
Install via NuGet Package Manager:
dotnet add package UA.Tenet.Web
Or via Package Manager Console:
Install-Package UA.Tenet.Web
Quick Start
Setting Up Tenet Web
using UA.Tenet.Web.Extensions;
var builder = WebApplication.CreateBuilder(args);
// Add Tenet MVC services
builder.Services.AddTenetMvc();
var app = builder.Build();
// Configure Tenet middleware
app.UseTenet(options =>
{
options.UseHttpsRedirection = true;
options.UseStaticFiles = true;
options.UseRouting = true;
});
app.Run();
Using Tag Helpers
@addTagHelper *, UA.Tenet.Web
<!-- Enhanced image tag with lazy loading and responsive images -->
<img src="~/images/product.jpg"
alt="Product Image"
class="product-image" />
Creating View Controllers
using UA.Tenet.Web.Abstractions;
public class HomeController : ViewController
{
public IActionResult Index()
{
return View();
}
public IActionResult About()
{
return View();
}
}
Configuring Web Options
app.UseTenet(options =>
{
options.UseHttpsRedirection = true;
options.UseStaticFiles = true;
options.UseRouting = true;
options.UseAuthentication = true;
options.UseAuthorization = true;
options.StaticFileOptions = builder =>
{
builder.RequestPath = "/static";
builder.OnPrepareResponse = ctx =>
{
ctx.Context.Response.Headers.Append("Cache-Control", "public,max-age=31536000");
};
};
});
Architecture
UA.Tenet.Web follows the Tenet Framework principles:
- Convention over Configuration: Automatic endpoint discovery and registration
- Performance: Leverages Minimal API performance benefits
- Structure: Maintains organized Controller-like structure
- Flexibility: Mix and match traditional controllers with minimal APIs
- Testability: Clean separation of concerns for easy testing
Integration with Swagger
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
var app = builder.Build();
app.UseSwagger();
app.UseSwaggerUI();
app.UseTenet();
Documentation
For comprehensive documentation, tutorials, and API reference, visit:
Made with ❤️ by UA Devs @ Chiclana de la Frontera (Spain)