Comprehensive .NET framework for building enterprise-grade backend and frontend applications — targets .NET 10 (LTS) and .NET 11 (STS)
- 🎯 CQRS Pattern - Command Query Responsibility Segregation for scalable applications
- 📱 Multi-Platform Support - ASP.NET Core, Blazor, MAUI, WPF, WinUI, UWP
- ☁️ Cloud Ready - Azure integration and multi-tenant support
- 📊 Monitoring & Observability - OpenTelemetry with Application Insights & Sentry
- 💾 Data Access - Entity Framework Core with advanced abstractions
- 📅 Event Sourcing - Domain event persistence and aggregate replay with AOT-compatible serialization
- ✉️ Communication - Mail, Message Bus, and SignalR capabilities
- 🔐 Authentication - Enterprise security patterns and multi-tenancy
- 🌍 Globalization - Multi-language and localization support
- 📄 Document Processing - PDF, Excel with Syncfusion support
- 🧮 Scientific Computing - Financial, Geography, Physics, Mathematics libraries
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.AspNetCore |  |
| I-Synergy.Framework.AspNetCore.Authentication |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.AspNetCore.Globalization |  |
| I-Synergy.Framework.AspNetCore.Monitoring |  |
| I-Synergy.Framework.AspNetCore.MultiTenancy |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.Core |  |
| I-Synergy.Framework.CQRS |  |
| I-Synergy.Framework.Automations |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.EntityFramework |  |
| I-Synergy.Framework.EventSourcing |  |
| I-Synergy.Framework.EventSourcing.EntityFramework |  |
| I-Synergy.Framework.EventSourcing.Storage |  |
| I-Synergy.Framework.EventSourcing.Storage.Azure |  |
| I-Synergy.Framework.EventSourcing.Storage.S3 |  |
| I-Synergy.Framework.Storage |  |
| I-Synergy.Framework.Storage.Azure |  |
| I-Synergy.Framework.Storage.S3 |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.Mail |  |
| I-Synergy.Framework.Mail.Microsoft365 |  |
| I-Synergy.Framework.Mail.SendGrid |  |
| I-Synergy.Framework.MessageBus |  |
| I-Synergy.Framework.MessageBus.Azure |  |
| I-Synergy.Framework.MessageBus.RabbitMQ |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.KeyVault |  |
| I-Synergy.Framework.KeyVault.Azure |  |
| I-Synergy.Framework.KeyVault.OpenBao |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.Monitoring |  |
| I-Synergy.Framework.Monitoring.Client |  |
| I-Synergy.Framework.OpenTelemetry |  |
| I-Synergy.Framework.OpenTelemetry.ApplicationInsights |  |
| I-Synergy.Framework.OpenTelemetry.Sentry |  |
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.UI |  |
| I-Synergy.Framework.UI.Blazor |  |
| I-Synergy.Framework.UI.Maui |  |
| I-Synergy.Framework.UI.WinUI |  |
| I-Synergy.Framework.UI.WPF |  |
All UI packages share a common accent color palette (ThemeColors.Colors) — 42 colors across 6 hue families (Red → Orange → Yellow → Green → Blue → Violet), each with 7 shades from mid-light to deep.
Regenerate at any time by running:
dotnet test tests/ISynergy.Framework.UI.Tests --filter GenerateColorPreviewHtml
| Package | Latest Version |
|---|---|
| I-Synergy.Framework.Documents |  |
| I-Synergy.Framework.Documents.Syncfusion |  |
| I-Synergy.Framework.Financial |  |
| I-Synergy.Framework.Geography |  |
| I-Synergy.Framework.Globalization |  |
| I-Synergy.Framework.IO |  |
| I-Synergy.Framework.Mathematics |  |
| I-Synergy.Framework.Physics |  |
| I-Synergy.Framework.Printer.Label |  |
| I-Synergy.Framework.Printer.Label.Dymo |  |
| I-Synergy.Framework.Mvvm |  |
⚠️ Deprecated Packages (Click to expand)
These packages are no longer maintained and should not be used in new projects.
| Package | Status |
|---|---|
| I-Synergy.Framework.Aspire.Proxy |  |
| I-Synergy.Framework.Logging.ApplicationInsights |  |
| I-Synergy.Framework.Logging.AppCenter |  |
| I-Synergy.Framework.UI.Uno |  |
| I-Synergy.Framework.UI.Maui.Blazor |  |
| I-Synergy.Framework.Update |  |
| I-Synergy.Framework.Update.Maui |  |
| I-Synergy.Framework.Update.WinUI |  |
| I-Synergy.Framework.Update.WPF |  |
| I-Synergy.Framework.Update.Uno |  |
| I-Synergy.Framework.AspNetCore.Blazor |  |
- Clean Architecture - Clear separation of concerns across Domain, Application, Infrastructure, and Presentation layers
- CQRS Pattern - Command Query Responsibility Segregation for scalable event-driven applications
- Event Sourcing - Domain event store with aggregate replay; pluggable
IEventSerializersupporting both reflection and AOT-safe source-generated JSON - Dependency Injection - Built-in DI throughout all layers
- Entity Framework Core - Data access with EF Core
DbSet<T>primitives directly on theDataContext(no repository abstraction) - Domain-Driven Design - Rich domain models with aggregate roots
- Vertical Slice Architecture - Feature-organized application structure
- Trim-aware - Trim analysis is enabled for the platform UI packages (
UI.WPF/UI.WinUI/UI.Maui) and reflection-heavy APIs are annotated with[RequiresUnreferencedCode]/[RequiresDynamicCode], with source generators replacing some reflection-based registration. Native AOT is a direction the code is being annotated toward, not yet a per-package guarantee.
- ✅ ASP.NET Core 10 and 11 - Web APIs and backend services
- ✅ Blazor - Interactive web components
- ✅ .NET MAUI - Cross-platform mobile & desktop (iOS, Android, Windows, macOS)
- ✅ WPF - Desktop applications
- ✅ WinUI - Modern Windows applications
- ✅ UWP - Universal Windows Platform
| Component | Status |
|---|---|
| I-Synergy.Framework | |
Contributions are welcome! Please refer to the Developer Guide for guidelines. The documentation site is built from docs/.
Work in this repository is delegated to the agent definitions under .ai/agents/ — one file per agent, for example architect.md; the main conversation plans, reviews and coordinates rather than editing code.
| Agent | Use for |
|---|---|
architect |
Feature design, pattern selection, component boundaries, architecture analysis |
reviewer |
Code quality, SOLID, CQRS compliance, security review, ISO/IEC 25010 finding attribution |
security |
Blast-radius and exposure analysis, threat modelling, OWASP review, dependency and secret audits |
tester |
MSTest/Reqnroll test design, BDD scenarios, integration test strategy |
designer |
Visual design — colour palettes, typography, branding, design tokens |
developer |
.NET/C# code — CQRS handlers, API endpoints, Blazor, EF Core, refactoring, builds |
programmer |
Programming and code implementation — writes, edits, builds and tests code |
ui-developer |
Blazor/MAUI components, layouts, CSS/styling, UX patterns |
ui-tester |
Playwright E2E tests, accessibility checks, visual regression |
winui-dev |
WinUI 3 desktop applications — Windows App SDK, XAML, features, conversions, bugs |
writer |
XML docs, READMEs, ADRs, technical prose |
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by I-Synergy
Azure DevOps • NuGet • GitHub
Engineering artifacts produced by this repository correspond to published standards, and their status
is computed from validator runs rather than asserted. The full view — what is produced, what is
aligned in practice only, and what stays outside a code repository's reach — is in
COMPLIANCE.md.
| Compatibility | Meaning | Standards |
|---|---|---|
| Evidence | An artifact a certification auditor can sample directly | (none) |
| Aligned | Engineering practice follows the standard's model; no audit artifact is produced | ISO/IEC/IEEE 29119-3:2021, ISO/IEC 25010:2023 |
| Organizational | Certifiable only at organization level; this repository supplies nothing for it | ISO/IEC 27001, ISO/IEC 27701 / ISO/IEC 27017 / ISO/IEC 27018, ISO 9001, ISO/IEC 15504 / ISO/IEC 33001, IEC 62304, ISO/IEC 42001 |
This is not a certification and it asserts no conformity with any standard. Certification is issued by an accredited third-party body after auditing an organizational management system; it cannot be established by a code repository.