Tech Stack 💪

• Blazor WebAssembly 5.0 - ASP.NET Core Hosted Model
• Entity Framework Core 5.0

Down the Roadmap

• Migration to .NET 6
• Multi Tenancy
• Better Localization - JSON

Getting Started 🦸

1. Install the latest .NET 5 SDK
2. Install the latest DOTNET & EF CLI Tools by using this command dotnet tool install --global dotnet-ef
3. Install the latest version of Visual Studio IDE 2019 (v16.8 and above) 🚀
4. Open up Command Prompt and run dotnet new --install WarehouseManger to install the project template
5. Create a folder for your solution and cd into it (the template will use it as project name)
6. Run dotnet new WarehouseManger to create a new Solution with all the Awesomeness 🕶️ of BlazorHero 🦸

Getting Started with Docker in Windows 🚀

• Install Docker on Windows via https://docs.docker.com/docker-for-windows/install/
• Open up Powershell on Windows and run the following
  • cd c:\
  • dotnet dev-certs https -ep $env:USERPROFILE\.aspnet\https\aspnetapp.pfx -p securePassword123
  • dotnet dev-certs https --trust
  • Note - Make sure that you use the same password that has been configured in the docker-compose.yml file. By default, securePassword123 is configured.
• 5005 & 5006 are the ports setup to run blazorHero on Docker, so make sure that these ports are free. You could also change the ports in the docker-compose.yml and Server\Dockerfile files.
• Now navigate back to the root of the BlazorHero Project on your local machine and run the following via terminal - docker-compose -f 'docker-compose.yml' up --build
• This will start pulling MSSQL Server Image from Docker Hub if you don't already have this image. It's around 500+ Mbs of download.
• Once that is done, dotnet SDKs and runtimes are downloaded, if not present already. That's almost 200+ more Mbs of download.
• PS If you find any issues while Docker installs the nuget packages, it is most likelt that your ssl certificates are not intalled properly. Apart from that I also added the --disable-parallel in the Server\Dockerfileto ensure network issues don't pop-up. You can remove this option to speed up the build process.
• That's almost everything. Once the containers are available, migrations are updated in the MSSQL DB, default data is seeded.
• Browse to https://localhost:5005/ to use your version of BlazorHero !

Complete Documentation 🚀

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.

The provided documentation / guide will get you started with BlazorHero in no-time. It provides a complete walkthrough about the project with to-the-point guides and notes.

Features

All the completed and the upcoming features are mentioned in the Features.MD File

Contributing

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

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

Here are the few contributions that I would highly appreciate ;)

• 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

• And finally, Stars from everyone! :D

License

Distributed under the MIT License.