Blazor is a web framework designed to run in the browser on a WebAssembly-based .NET runtime. Blazor Boilerplate aka Blazor Starter Template is a SPA admin template (WebAssembly / Core-Hosted) built with Blazor with a .NET Core 3 Server API. The UI for this application is by Material Design provided mostly by MatBlazor. Version 0.2.3 and below utlize AspNETCore Authorization / Authentication. Version 0.3.0 and up will be using Identity Server 4.
Goals
- To create a boilerplate with Blazor / Razor components that includes the most common functionality for an app that is lean yet powerful for anyone to start their own project rapidly.
- This repository is community driven. It is not and never will be controlled by a corporation.
- Minimal Javascript. Currently only using them for SignalR for the Forum. We may us components with JS in them but so far no Javascript has been written specifically for anything in the repository.
Live demo
Blazor Boilerplate - Kick the tires. The functionality grows every week. *Note Firewall does block some foreign IP addresses. Swagger UI to view the server API https://blazorboilerplate.com/swagger/index.html.
Prerequisites
Don't know what Blazor is? Read here
Complete all Blazor dependencies.
- .NET Core SDK 3.0.100
- Visual Studio 2019 Preview with the ASP.NET and web development workload selected.
- The Blazor templates on the command-line: dotnet new -i Microsoft.AspNetCore.Blazor.Templates::3.0.0-preview9.19465.2
- For Entity Framework Core on the command-line tools: dotnet tool install --global dotnet-ef --version "3.0.0
How to run
- Install dotnet-sdk 3.0.100 and the latest Visual Studio 2019 Preview.
- Clone or download.
- Open the solution in Visual Studio and press F5.
- Create a user using the
Create Account
button in the login page or login if you have already created a user. - To view the API using Swagger UI, Run the solution and go to: http://localhost:53414/swagger/index.html. Live example: https://blazorboilerplate.com/swagger/index.html
Publish on IIS
- Publish both the Client and Server projects.
- Upload Server project to website folder.
- Upload Client 'BlazorBoilerplate.Client' directory
Thanks To
Contributing
Please star, watch and fork! We'd greatly appreciate any contribution you make. I am very open to updates and features, though most feature requests will be depending on how much community support for it is.
Disclaimer / About the Author
I (Enkodellc) started this repository as I was frustrated with the examples out there that people were charging money for and were in my opinion incomplete or closed source. I paid for 4-5 of these solutions with an Angular front-end and none of them were what I was looking for. This is my attempt to create something that developers can start a Blazor project with several great features to build from. I have a lot of experience with ASP.Net webforms an new to .NET Core and Blazor. This code is not meant to be perfect or follow every Best Practice. It though is my ambition to learn and get feedback on what Best Practices can be implemented. I have taken small solutions from other repositories and will do my best to recognize those contributions. I am very open to ideas and suggestions. I am not a great developer, but I try. So please take this into consideration when using this repository.
Completed
- Basic Login / User Creation
- Admin Theme using Material Design / MatBlazor
- Swagger Ui API visualizer
- Log Files using Serilog
- Choose between SQL Lite File or MS SQL Database
- Email Confirmation of Registered Users
- Forgot Password Functionality
- Api Audit Trail / Middleware to log Api Requests and Responses
- Api Response Class to maintain consistent Api Requests and Responses
- Todo List CRUD Example with N-Tier Layers Not just some fluff that most others do
- Seed Database
- Forum chat and notification system - Thanks ajgoldenwings
- Drag and Drop Examples - Chris Sainty Blazor Blog
Road map
- Switch from Entity Framework Core to Dapper. So far EF is not my cup of Tea. I think dapper will be stronger and faster
- User profile & settings management
- User, claims, role, permission and organization unit management
- Azure Hosting Guide
- Docker Container
- Create a Nuget Package Template
License
This project is licensed under the terms of the MIT license.
News
0.3.0 (Breaking Changes - Under Development)
- Identity Server 4 First Release - Delete your DB! Thanks to ganmuru
- User Profile Store Last Page Visited / Return on Login
- .NET Core 3.0.100 / Blazor 3.0.0-preview9.19457.4 update
- Known Issues:
- IAuditable Shadow Properties not getting UserId
0.2.3 - .Net Core Authentication / Authorization
- .NET Core 3.0.100 / Blazor 3.0.0-preview9.19457.4 update
- Known Issues:
- IAuditable Shadow Properties not getting UserId
0.2.2
- Drag and Drop Examples
- .NET Core 3.0.0-rc1.19457.4 update
- Known Issues:
- IAuditable Shadow Properties not getting UserId
0.2.1
- Update to .NET Core 3.0 Preview 9
- User Management Screen (CRUD) & User Password Reset - Thanks npraskins
- Confirmation Delete Dialog Stylize & Implementation
- Known Issues:
- IAuditable Shadow Properties not getting UserId
0.2.0
- CRUD Todo List example
- Restructure Project Refactor BlazorBoilerplate.Shared for N-Tier Design
- Automapper for Client (dto) / Server Models
- Removed old Migrations. Recommend to delete your database to start new.
- Implement ShadowProperties for Auditable, SoftDelete Interfaces for Models (In Progress)
- DB Seed Data
- Forum chat and notification system - Thanks ajgoldenwings
- Known Issues:
- IAuditable Shadow Properties not getting UserId
0.1.9
- Update to SDK 3.0.0-preview8-28405-07
- Added IpAddress and UserId to Middleware ApiLogging
- Review / Fix VS code Warnings and Information notice. Clean up code.
- UserProfile - Beta
- MatBlazor 1.6.0
0.1.8
- Middleware to log Api Requests and Responses for auditing and debugging. Thanks salslab
- Middleware for consistent API Responses and Exception Handlin. Thanks proudmonkey
- Email Pop3 / IMAP retrieval. Thanks npraskins
- Responsive Navigation / Closed / Full / Minified / Minified & Hover effect
- Added MatNavMenu PR for MatBlazor - Ver 1.5
- Updated demo site for new MatNavMenu and rest of 0.1.8 code
0.1.7
- User Profile Management
- Refactor Email Settings and API
- MatBlazor 1.3.0
- Migrate to .NET Core 3.0
0.1.6
- Email confirmation on Registration
- Configure Email Configuration in server appsettings.json
- Set "RequireConfirmedEmail" to true in appsettings.json
- Forgot Password
- Configure Email Configuration in server appsettings.json
- Updated Email Templates for Forgot Password
0.1.5
- Added Azure DevOps Pipeline for build status
- Added Update Email Templates
- Implemented New User Registration Email Template
- Implement AuthorizeView for Theme
- Breakout Theme Components
0.1.4
- Add Mailkit for Email - Future work to add Email Templates
- Started API Auth CascadingAuthenticationState / Polices / Claims
- Added SQL Server as a DB option
0.1.3
- Update to MatBlazor 1.2.1 - Not yet released so using local copy
- Update Theme / Drawer minify & close
- Fixed Known Issue - UserProfile not loading after login. Thanks nstohler
- Secure Pages.
- Anonymous Home Page.
0.1.2
- Update to SDK 3.0.100-preview6-012264 - Breaking Changes
- Update to MatBlazor 1.2
- Update Theme
- Known Issue - UserProfile not loading after login
- Registration Form added Form Validation
- Todo Table Fetch from API Example
0.1.1
- Updated Theme / Responsive
- Added Serilog Log Files
0.1.0
- Initial release