snow-jallen / CleanArchitecture

Clean Architecture Template for Blazor WebAssembly Built with MudBlazor Components.

BlazorHero - Clean Architecture Template

For Blazor Web-Assembly
Explore the docs »

Report Bug · Request Feature

Detailed Quick Start Guide

Getting started with Blazor Hero – A Clean Architecture Template built for Blazor WebAssembly using MudBlazor Components. This project will make your Blazor Learning Process much easier than you anticipate. Blazor Hero is meant to be an Enterprise Level Boilerplate, which comes free of cost, completely open sourced.

Read the Quick Start Guide

Video Preview

Here is a quick video preview of this Open Soure Project - (https://www.facebook.com/codewithmukesh/posts/269621381402304)

Version 1.0.1 - Current Release - Features

• Mudblazor Component Library
• .NET 5.0+
• Blazor Web-Assembly: ASP.NET Core Hosted
• Onion Architecture
• Persistent Dark Mode (Local Storage)
• Service-Based Approach
• MediatR at API Level
• AutoMapper
• API Versioning
• JWT Authentication
• Serilog - Server-Side Only*
• Complete User Management
• Profile Picture
• Clean Fluid UI
• CRUD Functionalities
• Custom Error Pages
• Localization
• Role Management
• User-Role Management
• Swagger
• Middlewares
• Favicon
• Default User & Role Seeding
• Dynamic Service Registration (WASM)
• Auto DB Migrations
• Paginated API Responses
• Polly - Retry Pattern for HttpClient
• Shared Email Service
• Hangfire Implementation
• Custom API Response for 500,401,403
• Specification Pattern
• Permission Based UI Rendering
• Refresh Tokens
• HTTP Interceptor
• Logout User if Refresh Token Fails

Features To Be Included

Version 2.0 - Down the Road

• Breadcrumbs
• Caching
• Chat
• Notifications System using SignalR
• Charts
• PDF Downloads
• Theme Manager
• File Upload
• Import / Export to Excel
• Social Auth - Facebook, Google
• Audit Trails
• SEO

Contribution Needed

• Need someone to add in the API Documentation for Swagger.
• Need someone to implement localization throughout every Razor Component of the solution under the WASM(Client) Project. You can take the Pages/Authentication/Login.razor as the point of reference. It is as simple as adding @inject Microsoft.Extensions.Localization.IStringLocalizer<Login> localizer to every page, changing the texts to @localizer["Text Here"] and finally adding resx files to the Resources Folder as per the folder structure.
• Need few contributors to add in various language transalations as per the implemented Location. I got time to only add a few transalations for French as of now.
• Need a UI contributor to look at the UX/UI of the entire project
• Need someone to buildup a cool Material Logo for BlazorHero (BH):D Do contact me on LinkedIn (https://www.linkedin.com/in/iammukeshm/).
• And finally, Stars from everyone! :D