search

fullstackhero / dotnet-starter-kit

Production Grade Cloud-Ready .NET 8 Starter Kit (Web API + Blazor Client) with Multitenancy Support, and Clean/Modular Architecture that saves roughly 200+ Development Hours! All Batteries Included.
https://fullstackhero.net/dotnet-webapi-boilerplate/
MIT License
5.04k stars 1.5k forks source link
aws blazor boilerplate clean-architechture clean-architecture codewithmukesh docker dotnet dotnet8 fullstackhero modular-monolith multitenancy starter-kit template terraform vertical-slice-architecture webapi

readme

FullStackHero .NET 8 Starter Kit 🚀

With ASP.NET Core Web API & Blazor Client

FullStackHero .NET Starter Kit is a starting point for your next .NET 8 Clean Architecture Solution that incorporates the most essential packages and features your projects will ever need including out-of-the-box Multi-Tenancy support. This project can save well over 200+ hours of development time for your team.

FullStackHero .NET Starter Kit

Important

This project is currently work in progress. The NuGet package is not yet available for v2. For now, you can fork this repository to try it out. Follow @iammukeshm on X for project related updates.

Quick Start Guide

As the project is still in beta, the NuGet packages are not yet available. You can try out the project by pulling the code directly from this repository.

Prerequisites:

Please follow the below instructions.

  1. Fork this repository to your local.
  2. Open up the ./src/FSH.Starter.sln.
  3. This would up the FSH Starter solution which has 3 main components.
    1. Aspire Dashboard (set as the default project)
    2. Web API
    3. Blazor
  4. Now we will have to set the connection string for the API. Navigate to ./src/api/server/appsettings.Development.json and change the ConnectionString under DatabaseOptions. Save it.
  5. Once that is done, run the application via Visual Studio, with Aspire as the default project. This will open up Aspire Dashboard at https://localhost:7200/.
  6. API will be running at https://localhost:7000/swagger/index.html.
  7. Blazor will be running at https://localhost:7100/.

🔎 The Project

✨ Technologies

👨‍🚀 Architecture

📬 Service Endpoints

Endpoint Method Description
/token POST Generates Token.

🧪 Running Locally

🐳 Docker Support

☁️ Deploying to AWS

🤝 Contributing

🍕 Community

Thanks to the community who contribute to this repository! Submit your PR and join the elite list!

FullStackHero .NET Starter Kit Contributors

📝 Notes

Add Migrations

Navigate to ./api/server and run the following EF CLI commands.

dotnet ef migrations add "Add Identity Schema" --project .././migrations/postgresql/ --context IdentityDbContext -o Identity
dotnet ef migrations add "Add Tenant Schema" --project .././migrations/postgresql/ --context TenantDbContext -o Tenant
dotnet ef migrations add "Add Todo Schema" --project .././migrations/postgresql/ --context TodoDbContext -o Todo
dotnet ef migrations add "Add Catalog Schema" --project .././migrations/postgresql/ --context CatalogDbContext -o Catalog

What's Pending?

⚖️ LICENSE

MIT © fullstackhero