📐 Architecture Overview
Clean Architecture Benefits
- Separation of Concerns: Each layer has a single responsibility
- Testability: Business logic isolated from infrastructure
- Maintainability: Changes in one layer don't affect others
- Flexibility: Easy to swap databases, UI frameworks, or external services
📁 Project Structure
📁 BlazorBlueprint/
📁 Core/ - Business Logic Layer
📁 Application/ - Use cases, CQRS, MediatR
📁 Domain/ - Entities, value objects, interfaces
📁 ServiceDefaults/ - Shared configurations
📁 Infrastructure/ - Data Access Layer
📁 MongoDB/ - Database implementation
📁 Extensions/ - Service registrations
📁 Web/ - Presentation Layer
📁 BlazorBlueprint.Web/ - Blazor Server UI
📁 Services/ - API Services
📁 ApplicationService/ - REST API endpoints
📁 WorkerService/ - .NET Worker Service for background processing
📁 Dev/ - Development Tools
📁 AppHost/ - .NET Aspire orchestration
📁 .github/workflows/ - GitHub Actions CI/CD
📁 .azure/devops/ - Azure DevOps CI/CD
🏗️ Solution Architecture
Clean Architecture with .NET Aspire orchestration
🎨 Presentation Layer
Blazor Web
UI Components, Pages, Controllers
SignalR Hubs
Real-time Communication
PWA
Service Worker, Manifest
⚙️ Application Layer
Services
Business Logic, Use Cases
Interfaces
Service Contracts, Abstractions
Models
DTOs, ViewModels, Settings
🏛️ Domain Layer
Entities
Business Objects, Domain Models
Interfaces
Repository Contracts, Domain Abstractions
Extensions
Domain Logic, Business Rules
🔧 Infrastructure Layer
MongoDB
Data Persistence, Repository Implementation
Redis
Page Output Caching, API Response Caching, SignalR Backplane
Kafka
Message Queue, Background Job Processing
.NET Worker Service
Background Processing, Queue Processing
Email Providers
SendGrid, SMTP, MailerSend, Mailgun
AI Services
OpenAI API, Chat Moderation
Identity
ASP.NET Core Identity, Custom Stores
🚀 .NET Aspire Orchestration
Service Discovery
Health Checks
Service Communication
Observability
Container Orchestration
Resource Management
🌐 External Services
Identity Providers
Email Services
AI APIs
Application Service
🛠️ Technology Stack
Built with modern technologies and best practices
Frontend
Blazor Server
Fluent UI
Responsive Design
Backend
.NET 10
ASP.NET Core
SignalR
MongoDB
Redis Caching
Output Caching
Distributed Caching
SignalR Backplane
IRepository Pattern
Architecture
Clean Architecture
Service Layer Pattern
Dependency Injection
Generic Repository
DevOps & Deployment
Docker
Docker Compose
Azure DevOps
GitHub Actions
Docker Hub
GitHub Container Registry
CI/CD Pipelines
Container Orchestration
Kubernetes
Multi-Stage Builds
Features
Identity & Auth
Real-time Chat
Content Management
AI Integration
Multi-Tenant SaaS
PWA Support
Push Notifications
Support System
User Management
Dynamic Pages
Audit Logging
GDPR Compliance
.NET Worker Service
Kafka
Kubernetes
Multi-Provider Email
External OAuth (Facebook & Google)
SEO Optimization
Two-Factor Auth
Theme Management
Notification Preferences
Personal Data Management
External Login Management
📦 Ready to Download?
Start building with Blazor Blueprint's Clean Architecture today. Download the free Developer version or get Enterprise with premium plugins and commercial licensing.
🔓 Open Source on GitHub • Free for personal/non-commercial use • Enterprise license (£399) required for commercial use • Full source code included