Dotnet6 blazor clean code, CQRS ready, hangfire and OpenId connect configured template, blazor login with jwt

An easy to use template to show how to develop CQRS and background jobs by .net 6 in an micro-service architecture Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Roadmap
4. Contributing
5. License
6. Contact

About The Project

You can see plenty of individual projects on .net clean code or CQRS implementation in .net, but what if you need all those in micro-service enabled template? Or

What if you need to authorize clients by passwordflow? What if you are new in blazor type and need to authenticate clients by JWT in it? Are you exhausted of initiating project and do repeatedly efforts project to project? Would you like to a have a separate servie to not only authorize your api by JWT but also authorize your Blazor clients interatedly?

What you will achieve :

• A micro-service architectured OpenIdConnect and identity authorization service
• A clean code and Multi-Tiered structure
• Hangfire installed and configured to do back ground jobs
• CQRS pattern enabled by using of MediatR library
• Unit and integration tests
• Configuration and usage of AutoMapper library
• Good example of how to use docker compose to connect two project by docker compose

(back to top)

Built With

• .net6
• MediatR
• AutoMapper
• Openiddict-Core
• EfCore

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them. Before all, make sure you have installed .net6 in your machine!

• clone the repo

  git clone https://github.com/rezabashiri/blazor-boiler-plate.git

• dotnet

  dotnet build ./"Blazor boilerplate.sln"

Installation

Below is how you can run your project via docker compose.

1. Clone the repo

   git clone https://github.com/rezabashiri/blazor-boiler-plate.git

2. Run docker

   docker compose up -d

3. Head to https://localhost:9001

4. Use Email: [email protected] and Password: Reza123$%^ to login

5. Refer to http://localhost:9002/swagger/ to see available APIs

(back to top)

Roadmap

• Add CQRS pattern
• Add hangfire
• Add authentication and authorization services
• Write instrcution document
• Add ability of CRUD on users

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Reza Bashiri - https://rezabashiri.com/ - [email protected] - Linkedin

Project Link: https://github.com/rezabashiri/blazor-boiler-plate

(back to top)