Skip to content

khsadek/MudBlazorCrmApp

 
 

Repository files navigation



Logo

MudBlazor CRM

A feature-rich sample CRM application built with Blazor WASM and .NET, showcasing the power of MudBlazor and a modern ASP.NET Core backend.

GitHub Actions Workflow Status


MudBlazor CRM


🚀 About The Project

This repository is a comprehensive, modern web application built on the latest .NET stack. It serves as a practical example of a Customer Relationship Management (CRM) system using a Blazor WASM client and an ASP.NET Core server.

The goal is to demonstrate best practices and the seamless integration of powerful open-source technologies to build a real-world, data-driven application.

Key highlights include:

  • A clean, responsive UI powered by MudBlazor.
  • Secure user management with ASP.NET Core Identity.
  • An efficient and queryable API using OData.
  • A lightweight and cross-platform SQLite database.

✨ Features

  • 🖥️ Modern Frontend: A rich, single-page application (SPA) experience with Blazor WASM.
  • 🎨 Beautiful UI Components: Leverages the extensive and professional MudBlazor component library.
  • 🔐 Secure Authentication: Full user registration and login system via ASP.NET Core Identity.
  • 🚀 High-Performance Backend: Built on the fast and reliable ASP.NET Core Kestrel web server.
  • 🗃️ Flexible Data Queries: OData support allows for powerful and efficient API queries directly from the client.
  • 📝 Interactive API Docs: Includes Swagger (OpenAPI) for easy API exploration and testing.
  • 📊 Kanban Task Management: A sample Kanban board to demonstrate dynamic UI and data interaction.
  • 🪶 Lightweight Database: Uses Entity Framework Core with SQLite for simple setup and development.

🛠️ Tech Stack

This project is built with a curated set of modern technologies:

Technology Description
.NET Core application framework
ASP.NET Core Web framework for building the server
Blazor Frontend C# web framework
MudBlazor Material Design component library
Entity Framework Core Object-Relational Mapper (ORM)
SQLite Embedded database engine
OData Standard for building RESTful APIs
Swagger API documentation and testing

🏁 Getting Started

Follow these instructions to get a copy of the project up and running on your local machine for development and testing.

Prerequisites

Make sure you have the following tools installed:

Installation & Running

  1. Clone the repository

    git clone https://github.com/donpotts/MudBlazorCrmApp.git
  2. Navigate to the project directory

    cd MudBlazorCrmApp
  3. Open the solution in Visual Studio

    • Open MudBlazorCrmApp.sln with Visual Studio 2022.
  4. Run the application

    • Set MudBlazorCrmApp as the startup project.
    • Press F5 or the "Run" button to build and start the application.
    • The application will launch in your default web browser. The database will be created and seeded on the first run.

Authentication

This application uses ASP.NET Core Identity for user authentication. To log in, navigate to the login page and enter your credentials.

Administrator

Username: [email protected]

Password: testUser123!

Normal user

Username: [email protected]

Password: testUser123!


📬 Contact

Don Potts - [email protected]

About

Blazor WASM Sample CRM application using MudBlazor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 54.8%
  • HTML 41.3%
  • CSS 2.5%
  • JavaScript 1.4%