Nextended Projects

This document provides an overview of all projects in the Nextended solution.

Core Libraries

Nextended.Core

Description: The foundation library providing essential extension methods and custom types.

Key Features:

Extensive extension methods for built-in .NET types
Custom types (Money, Date, BaseId, SuperType, Range)
Object mapping and cloning
Serialization helpers

NuGet: Nextended.Core

Nextended.Cache

Description: Caching utilities and extensions for simplified caching operations.

Key Features:

Unified caching provider interface
Extensions for IMemoryCache
Automatic cache expiration management

NuGet: Nextended.Cache

Nextended.EF

Description: Entity Framework Core extensions for enhanced database operations.

Key Features:

Graph loading (LoadGraphAsync, IncludeAll, MultiInclude)
Declarative, reusable include definitions (IncludeDefinitionFor<T>, attribute-driven, composable, glob/regex filters)
Query helpers: WhereContains, WhereKeyMatches, WhereBetween, WhereIn, WhereIf, ExistsAsync
Paging & dynamic sorting: Page, ToPagedResultAsync, OrderByMember(s), PagedResult<T>
Conditional includes/tracking: IncludeIf, AsTrackingIf, AsNoTrackingIf
DbContext helpers: PK inspection, DetachAll, GetOrAddAsync / GetOrCreateAsync
Bulk ops: BulkInsertAsync, BulkDeleteWhereAsync, UpsertAsync / UpsertRangeAsync (with InMemory fallback)

NuGet: Nextended.EF

UI Libraries

Nextended.Blazor

Description: Blazor-specific helpers, components, and extensions.

Key Features:

Blazor component utilities
JavaScript interop helpers
Navigation and localization extensions

NuGet: Nextended.Blazor

Nextended.UI

Description: WPF and Windows Forms utilities for desktop applications.

Key Features:

ViewUtility for UI operations
WPF behaviors and templates
ViewModel base classes
Theming support

NuGet: Nextended.UI Platform: Windows only

Nextended.Web

Description: ASP.NET Core and web application helpers.

Key Features:

Controller extensions
HTTP utilities
OData helpers
Web-specific extensions

NuGet: Nextended.Web

ASP.NET Core Add-ons

Nextended.ResponseFilters

Description: Fluent, attribute-aware pipeline that mutates response DTOs (redact, mask, hash, round, truncate, transform, filter collections) before serialization.

Key Features:

ResponseFilter<T> base class with FluentValidation-style rule builders (Nullify, Mask, Hash, Round, Truncate, RemoveItems, Take, Apply, …)
Full predicate matrix (sync/async, no-arg/ctx-aware/instance-aware)
Compiled property accessors, type-graph cache, cycle detection
ASP.NET Core adapter ships as Nextended.ResponseFilters.AspNetCore

NuGet: Nextended.ResponseFilters, Nextended.ResponseFilters.AspNetCore

Specialized Libraries

Nextended.Imaging

Description: Image processing and manipulation utilities.

Key Features:

Comprehensive ImageHelper class
Image format conversions
Dimension handling
Cached image processing

NuGet: Nextended.Imaging

Nextended.CodeGen

Description: Compile-time source code generation from various sources.

Key Features:

DTO generation from attributes
Class generation from JSON/XML
Excel-to-class generation
Roslyn source generator

NuGet: Nextended.CodeGen

Nextended.Aspire

Description: Extensions for .NET Aspire distributed applications.

Key Features:

Conditional dependency configuration
Environment variable management
Docker runtime checks
Endpoint configuration helpers

NuGet: Nextended.Aspire

Nextended.Aspire.Hosting.Supabase

Description: Full Supabase stack as a single Aspire resource — Postgres, GoTrue, PostgREST, Storage, Kong, Studio, Edge Functions.

Key Features:

One-line AddSupabase("supabase") spins up the complete stack
Per-sub-resource fluent configuration (ConfigureDatabase, ConfigureAuth, …)
Schema/data/storage/edge-function sync from remote Supabase projects
Local SQL migrations, pre-registered dev users, dashboard “Clear All Data” command
Azure Container Apps deployment via azd

NuGet: Nextended.Aspire.Hosting.Supabase

Nextended.Aspire.Hosting.N8n

Description: The n8n workflow-automation platform as a single Aspire resource — n8n, PostgreSQL backend, optional Redis + workers.

Key Features:

One-line AddN8n("n8n") with an auto-created PostgreSQL backend and sensible self-hosting defaults
Bring your own database (WithDatabase) or use bundled SQLite (WithSqlite)
Queue mode with Redis and scalable worker containers (WithQueueMode)
Basic auth, encryption key, webhook/editor URLs, timezone, workflow/credential import
Lightweight N8nApiClient for services + Azure Container Apps deployment via azd

NuGet: Nextended.Aspire.Hosting.N8n

Nextended.AutoDto

Description: Automatic DTO generation support library.

Key Features:

DTO generation infrastructure
Works with Nextended.CodeGen

NuGet: Nextended.AutoDto

Quick Reference Matrix

Project	Target	Platform	Dependencies
Nextended.Core	.NET Standard 2.0+, .NET 8/9/10	Cross-platform	None
Nextended.Cache	.NET 8/9/10	Cross-platform	Core
Nextended.EF	.NET 8/9/10	Cross-platform	Core, EF Core
Nextended.Blazor	.NET 8/9/10	Browser	Core, Blazor
Nextended.UI	.NET 8/9/10	Windows	Core, WPF
Nextended.Web	.NET 8/9/10	Cross-platform	Core, EF, ASP.NET
Nextended.ResponseFilters	.NET 8/9/10	Cross-platform	Core
Nextended.ResponseFilters.AspNetCore	.NET 8/9/10	Cross-platform	ResponseFilters, ASP.NET
Nextended.Imaging	.NET 8/9/10	Cross-platform	Core, Cache
Nextended.CodeGen	.NET Standard 2.0	Build-time	Roslyn
Nextended.Aspire	.NET 8/9/10	Cross-platform	Aspire
Nextended.Aspire.Hosting.Supabase	.NET 8/9/10	Cross-platform	Aspire
Nextended.Aspire.Hosting.N8n	.NET 8/9/10	Cross-platform	Aspire, PostgreSQL, Redis
Nextended.AutoDto	.NET Standard 2.0	Build-time	Roslyn

Installation

Install any package via NuGet:

dotnet add package [PackageName]

For example:

dotnet add package Nextended.Core
dotnet add package Nextended.Blazor

Getting Help

Check individual project documentation for detailed information
Visit the Examples section for code samples
Review the API Reference for detailed API documentation
Submit issues on GitHub