BlazorBoilerplate
A production-ready Blazor starter template with MudBlazor UI, supporting both WebAssembly and Server-Side modes, built on .NET 7.
What is BlazorBoilerplate?
Blazor Boilerplate is an open-source starter template for building production-ready Blazor applications. It provides a pre-configured admin dashboard with authentication, user management, audit logging, and support for both WebAssembly and Server-Side Blazor modes. The template solves the problem of repetitive setup by offering a solid foundation with essential features, allowing developers to quickly start building real-world applications.
Developers and teams building enterprise or SaaS applications with Blazor who need a robust, customizable starting point with built-in security and admin features.
Developers choose Blazor Boilerplate because it offers a comprehensive, community-driven template with minimal external dependencies, dual Blazor mode support, and proven use in production environments (e.g., a SaaS app with 1,200 daily users). Its focus on maintainability and real-world features saves significant development time compared to building from scratch.
Overview
Blazor Boilerplate / Starter Template with MudBlazor
Use Cases
Best For
- Building admin dashboards or internal tools with Blazor
- Creating SaaS applications with user management and authentication
- Starting a new Blazor project with production-ready features
- Developing applications that require audit trails and logging
- Projects needing support for both WebAssembly and Server-Side Blazor
- Teams looking for a customizable, open-source alternative to commercial Blazor templates
Not Ideal For
- Projects requiring heavy integration with JavaScript libraries not built for Blazor, as the template emphasizes minimal JS usage
- Teams wanting a lightweight, unopinionated starter without pre-built admin features like audit trails and user management
- Applications needing robust real-time debugging in WebAssembly mode, given the limited debugging support highlighted in the README
- Developers who prioritize frequent, seamless updates to the latest .NET versions, as the project has experienced periods of inactivity and breaking changes
Pros & Cons
Pros
Supports both WebAssembly and Server-Side Blazor, allowing runtime choice for performance or debugging, with mode switching via admin settings as per the README.
Includes authentication, role-based access control, Serilog audit logging, and multi-database support, proven in a SaaS app with 1,200 daily users mentioned by the author.
Built on MudBlazor for Material Design components, providing a customizable interface without extensive CSS work, as noted in the UI framework adoption.
Maintained without corporate control, with active Gitter discussions and contributor recognition, aligning with the goal of developer-centric evolution.
Cons
Docker support has known issues with SSL and service workers, and IIS deployment requires manual certificate and binding configurations, creating hurdles for production setups.
The README admits Breeze for Entity Framework is a main roadblock, with limited examples, forcing developers to rely on external tutorials for basic data operations.
WebAssembly debugging is limited, and switching Blazor modes causes browser caching issues, requiring incognito mode use, which disrupts development workflow.
History shows breaking changes between versions (e.g., 0.6.0 refactor) and periods of inactivity, risking stability for projects dependent on latest updates.
Frequently Asked Questions
Related Projects
TheIdServerOpenID/Connect, OAuth2, WS-Federation and SAML 2.0 server based on Duende IdentityServer and ITFoxtec Identity SAML 2.0 with its admin UI
BlazorWithIdentityA project template for a blazor hosted app using cookie based authentication with ef core identity.
Blorc.OpenIdConnectBlorc.OpenIdConnect provides a robust and secure way to integrate OpenID Connect authentication into Blazor applications. It simplifies the implementation of the Authorization Code Flow with Proof Key for Code Exchange (PKCE), which is the recommended method for securing single-page applications. ## Key Features - **PKCE Support** — Implements the Authorization Code Flow with Proof Key for Code Exchange to prevent CSRF and authorization code injection attacks. - **Automatic Token Management** — Handles access token delegation, expiration, and silent renewal automatically. - **Flexible Configuration** — Supports configuration via appsettings.json or programmatic options with extensible query and token parameters. - **User Info Loading** — Optionally loads additional identity data from the user info endpoint to populate user profiles. - **Identity Server Integration** — Designed to work with identity providers like Keycloak and Auth0 following standard OpenID Connect specifications. ## Philosophy The library follows a secure-by-design approach, enforcing modern authentication standards while providing a developer-friendly API that integrates seamlessly with Blazor's component and service model.
BlazorWasmOidcKeycloakBlazor WebAssembly Standalone App with OIDC Authentication
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.