ABP Microservice Template

January 28, 2026 ยท View on GitHub

NuGet Badge

Why this template?

This is a template for creating a microservice with ABP using dotnet. This template is created to make it easier to create a new microservice project with ABP. It is based on the blog post, .NET Microservice with ABP series I made earlier. It is created using the dotnet new template engine and it is available on NuGet.

Usage

Install the template

dotnet new install Anto.Abp.Microservice.Template

Create a new project

dotnet new abp-ms -n MyProjectName

Quick Start (Development)

After cloning or creating a project from this template:

# First-time setup
make install          # Restore tools and install git hooks
make build            # Build the solution

# Run the application
make run              # Run with .NET Aspire (includes all services)

# Or use individual commands
dotnet tool restore
dotnet husky install
cd src && dotnet build Tasky.sln
cd src/apps/Tasky.AppHost && dotnet run

Available Makefile commands:

  • make help - Show all available targets
  • make dev-help - Show quick start guide
  • make build - Build the solution
  • make test - Run tests
  • make format - Format code
  • make fix - Auto-fix analyzer issues + format
  • make run - Run with Aspire orchestration

See the Makefile for all available commands.

Documentation

You can find everything in this repo explained here. There is also a YouTube Video for this project.

Features

  • Docker support
  • API Gateway with YARP
  • Frontend with Angular
  • Swagger UI
  • Authentication and Authorization
  • ABP 7.0 support
  • Blazor UI
  • Any suggestions? Create an issue or a pull request.

License

This project is licensed under the MIT License.

Contributing

If you have any suggestions or improvements, please feel free to create an issue or a pull request.

Acknowledgments

Author

Anto Subash - antosubash.com

If you like this project, please consider supporting me on PayPal. Thank you!

Disclaimer

This project is not affiliated with the ABP Framework project or the ABP Framework team. It is created by a community member. I am not responsible for any issues that may arise from using this template. Use at your own risk.

Changelog

You can find the changelog here.

TODO

  • Create a template for creating a new microservice.
  • Getting Started guide.
  • Add a new service guide.
  • Any suggestions? Create an issue or a pull request.

Resources

  • If you are new to ABP, you can find the documentation here.
  • If you are new to microservices, you can find the documentation here.
  • If you are new to Docker, you can find the documentation here.
  • If you are new to YARP, you can find the documentation here.
  • If you are new to Angular, you can find the documentation here.
  • If you are new to Swagger, you can find the documentation here.
  • If you are new to Openiddict, you can find the documentation here.