π‘ ποΈ A boilerplate CQRS (API + Worker) template for .NET
This is a template repository that sets the basic code and infrastructure for a repository/solution in .NET C# to create a CQRS project with API and worker.
Note
A appveyor.yml file is included for AppVeyor CI pipeline. AppVeyor is free for open-source projects. For closed-source projects, consider a paid subscription or other CI tools (GitHub Actions, CircleCI, TeamCity).
Warning
The automated process listed below now supports Windows and Linux/MAC environments.
- Click on the green button USE THIS TEMPLATE.
- Give a name to your new project/repository.
- Clone your newly created repository to your machine.
- Execute/run the file
initial-setup.bat
orinitial-setup.ps1
orinitial-setup.sh
and follow the instructions on the prompt/terminal.
- Click on the green button USE THIS TEMPLATE.
- Give a name to your new project/repository.
- Clone your newly created repository to your machine.
- Delete this file (
README.md
) and renameREADME.template.md
toREADME.md
. - Change the
appveyor.yml
with your tokens (use secure tokens) or use your preferred CI tool (Circle CI, GitHub Actions, Jenkins, Team City, Azure DevOps). - Change
SolutionName.sln
to your solution/project name. - Change project name (
SolutionName.csproj
,SolutionName.Tests.csproj
,SolutionName.IntegrationTests.csproj
) and namespace inside directoriesSrc
andTests
. - Change the main project reference in the tests project in files
Tests/SolutionName.Tests.csproj
andTests/SolutionName.IntegrationTests.csproj
. - Fix in the
README.md
the path of the badges. (change all {username}/{repo} tokens with your own data). - Add to
README.md
usage instructions of your client/SDK. - Update
_config.yml
with project details (github.io docs website).
Licensed under: MIT license (LICENSE or http://opensource.org/licenses/MIT).
This will also be your project's LICENSE, but you can change it to another one that suits your needs.