{"id":22343832,"url":"https://github.com/genocs/clean-architecture-template","last_synced_at":"2025-07-14T21:34:02.368Z","repository":{"id":41967642,"uuid":"256959831","full_name":"Genocs/clean-architecture-template","owner":"Genocs","description":"The Clean Architecture Template built on top of .NET8","archived":false,"fork":false,"pushed_at":"2024-09-23T23:40:00.000Z","size":4100,"stargazers_count":49,"open_issues_count":5,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T23:04:31.643Z","etag":null,"topics":["template"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Genocs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"genocs","custom":["https://www.buymeacoffee.com/genocs"]}},"created_at":"2020-04-19T09:23:45.000Z","updated_at":"2025-03-28T07:59:25.000Z","dependencies_parsed_at":"2023-10-16T06:55:01.049Z","dependency_job_id":"89fd5c35-0df3-4f95-85bd-83b3eb072e50","html_url":"https://github.com/Genocs/clean-architecture-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genocs%2Fclean-architecture-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genocs%2Fclean-architecture-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genocs%2Fclean-architecture-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genocs%2Fclean-architecture-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Genocs","download_url":"https://codeload.github.com/Genocs/clean-architecture-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249117234,"owners_count":21215353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["template"],"created_at":"2024-12-04T09:06:21.985Z","updated_at":"2025-04-15T17:24:46.596Z","avatar_url":"https://github.com/Genocs.png","language":"C#","funding_links":["https://opencollective.com/genocs","https://www.buymeacoffee.com/genocs","https://www.buymeacoffee.com/genocs)!"],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT SHIELDS --\u003e\n[![License][license-shield]][license-url]\n[![Build][build-shield]][build-url]\n[![Packages][package-shield]][package-url]\n[![Downloads Prev][downloads-prev-shield]][downloads-prev-url]\n[![Downloads][downloads-shield]][downloads-url]\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Discord][discord-shield]][discord-url]\n[![Gitter][gitter-shield]][gitter-url]\n[![Twitter][twitter-shield]][twitter-url]\n[![Twitterx][twitterx-shield]][twitterx-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n[license-shield]: https://img.shields.io/github/license/Genocs/clean-architecture-template?color=2da44e\u0026style=flat-square\n[license-url]: https://github.com/Genocs/clean-architecture-template/blob/main/LICENSE\n[build-shield]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml/badge.svg?branch=main\n[build-url]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml\n[package-shield]: https://img.shields.io/badge/nuget-v.3.1.0-blue?\u0026label=latests\u0026logo=nuget\n[package-url]: https://github.com/Genocs/clean-architecture-template/actions/workflows/build_and_test.yml\n[downloads-prev-shield]: https://img.shields.io/nuget/dt/Genocs.CleanArchitectureTemplate.svg?color=2da44e\u0026label=downloads%20prev\u0026logo=nuget\n[downloads-prev-url]: https://www.nuget.org/packages/Genocs.CleanArchitectureTemplate\n[downloads-shield]: https://img.shields.io/nuget/dt/Genocs.CleanArchitecture.Template.svg?color=2da44e\u0026label=downloads\u0026logo=nuget\n[downloads-url]: https://www.nuget.org/packages/Genocs.CleanArchitecture.Template\n[contributors-shield]: https://img.shields.io/github/contributors/Genocs/clean-architecture-template.svg?style=flat-square\n[contributors-url]: https://github.com/Genocs/clean-architecture-template/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Genocs/clean-architecture-template?style=flat-square\n[forks-url]: https://github.com/Genocs/clean-architecture-template/network/members\n[stars-shield]: https://img.shields.io/github/stars/Genocs/clean-architecture-template.svg?style=flat-square\n[stars-url]: https://img.shields.io/github/stars/Genocs/clean-architecture-template?style=flat-square\n[issues-shield]: https://img.shields.io/github/issues/Genocs/clean-architecture-template?style=flat-square\n[issues-url]: https://github.com/Genocs/clean-architecture-template/issues\n[discord-shield]: https://img.shields.io/discord/1106846706512953385?color=%237289da\u0026label=Discord\u0026logo=discord\u0026logoColor=%237289da\u0026style=flat-square\n[discord-url]: https://discord.com/invite/fWwArnkV\n[gitter-shield]: https://img.shields.io/badge/chat-on%20gitter-blue.svg\n[gitter-url]: https://gitter.im/genocs/\n[twitter-shield]: https://img.shields.io/twitter/follow/genocs?color=1DA1F2\u0026label=Twitter\u0026logo=Twitter\u0026style=flat-square\n[twitter-url]: https://twitter.com/genocs\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://www.linkedin.com/in/giovanni-emanuele-nocco-b31a5169/\n[twitterx-shield]: https://img.shields.io/twitter/url/https/twitter.com/genocs.svg?style=social\n[twitterx-url]: https://twitter.com/genocs\n\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./assets/genocs-library-logo.png\" alt=\"icon\"\u003e\n\u003c/p\u003e\n\n# Clean Architecture Template \nBuilt for .NET8. It incorporates the most essential Packages your projects will ever need. Follows Clean Architecture Principles.\n\nThe template can be used with the `dotnet new` command or with the `Visual Studio 2022` or `Visual Studio Code` IDEs.\n\n## Goals\n\nThis is an Application Template built to help you create LOB applications. It follows the Clean Architecture Principles and built on Domain-Driven-Design. This tool is useful to increases productivity on developing your next microservices.\nThe template allows you to use different databases and enterprise service bus.\n\n### Databases supported:\n- InMemoryDB (for development purpose)\n- SqlServer\n- MongoDB\n\n\n### Enterprise Service Bus libraries supported:\n- Particular NServiceBus\n- MassTransit\n- Rebus\n\n## Prerequisites\n- [.NET 8.x](https://dotnet.microsoft.com/download/dotnet/8.0)\n\n- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/preview/vs2022/)(optional)\n- [Visual Studio Code](https://code.visualstudio.com/download)(optional)\n- [Rider](https://www.jetbrains.com/rider/)(optional)\n\n\n## Getting Started\n\nOpen up your *Command Prompt* or *PowerShell* or \"bash\" and run the following command.\n\n``` bash\n# To clone the repository\ngit clone https://github.com/Genocs/clean-architecture-template\n# To build the nuget package\nnuget pack ./src/Package.Template.nuspec -NoDefaultExcludes -OutputDirectory ./out -Version 3.1.0\n```\n\n\n``` bash\n# To install the template\ndotnet new install Genocs.CleanArchitecture.Template\n```\n\nor, \n\nif you want to use a specific version of the template, \n\nuse\n\n``` bash\ndotnet new install Genocs.CleanArchitecture.Template::3.1.0\n```\n\nThis would install the `Genocs CleanArchitecture Template` globally on your machine.\n\nFor more details on getting started, [read the documentation](https://genocs-blog.netlify.app/library/)\n\n\nPlease check the [documentation](https://learn.microsoft.com/en-us/visualstudio/ide/how-to-locate-and-organize-project-and-item-templates?view=vs-2022) for more details. \n\n\n## How to create a project\n\nCreate, build, test and run:\n\n``` bash\ndotnet new -i Genocs.CleanArchitecture.Template\ndotnet new cleanarchitecture -n {CompanyName.ProjectName.ServiceName}\ncd {CompanyName.ProjectName.ServiceName}\ndotnet build ./src/{CompanyName.ProjectName.ServiceName}.WebApi\ndotnet build ./src/{CompanyName.ProjectName.ServiceName}.Worker\n\ndotnet test\ndotnet run ./src/{CompanyName.ProjectName.ServiceName}.WebApi\n```\n\n\n## How to build the package\n\nTo build the package run the following commands:\n\n[Official Link](https://docs.microsoft.com/en-us/dotnet/core/tools/custom-templates)\n\n\n``` bash\ncd ./src\nnuget pack\ndotnet new u Genocs.CleanArchitecture.Template\ndotnet new i ./out/Genocs.CleanArchitecture.Template.3.1.0.nupkg\ndotnet new cleanarchitecture --help\ndotnet new cleanarchitecture --name {MyCompany.MyProject} -d mongodb -sb particular\n```\n\n\n## Sample application\n\nRun `dotnet new -i Genocs.CleanArchitecture.Template` then try the following commands.\n\n\n``` bash\n# Complete suite of use cases.\ndotnet new cleanarchitecture --use-cases full\n\n# Register account and get customer details.\ndotnet new cleanarchitecture --use-cases basic\n\n# Read only use cases\ndotnet new cleanarchitecture --use-cases readonly\n```\n\n\n## Miscellaneous\n\nUseful commands:\n\n``` bash\n# How to get the list of installed templates\ndotnet new -u\n\ndotnet --list\n```\n## Changelogs\n\nView Complete [Changelogs](https://github.com/Genocs/clean-architecture-template/blob/main/CHANGELOGS.md).\n\n## License\n\nThis project is licensed with the [MIT license](LICENSE).\n\n\n## Community\n\n- Discord [@genocs](https://discord.com/invite/fWwArnkV)\n- Facebook Page [@genocs](https://facebook.com/Genocs)\n- Youtube Channel [@genocs](https://youtube.com/c/genocs)\n\n\n## Support\n\nHas this Project helped you learn something New? or Helped you at work?\nHere are a few ways by which you can support.\n\n- ⭐ Leave a star!\n- 🥇 Recommend this project to your colleagues.\n- 🦸 Do consider endorsing me on LinkedIn for ASP.NET Core - [Connect via LinkedIn](https://www.linkedin.com/in/giovanni-emanuele-nocco-b31a5169/) \n- ☕ If you want to support this project in the long run, consider [buying me a coffee](https://www.buymeacoffee.com/genocs)!\n  \n\n[![buy-me-a-coffee](./assets/buy-me-a-coffee.png \"buy me a coffee\")](https://www.buymeacoffee.com/genocs)\n\n## Code Contributors\n\nThis project exists thanks to all the people who contribute. [Submit your PR and join the team!](CONTRIBUTING.md)\n\n[![genocs contributors](https://contrib.rocks/image?repo=Genocs/clean-architecture-template \"genocs contributors\")](https://github.com/Genocs/clean-architecture-template/graphs/contributors)\n\n## Financial Contributors\n\nBecome a financial contributor and help me sustain the project.\n\n**Support the Project** on [Opencollective](https://opencollective.com/genocs)\n\n\u003ca href=\"https://opencollective.com/genocs\"\u003e\u003cimg src=\"https://opencollective.com/genocs/individuals.svg?width=890\"\u003e\u003c/a\u003e\n\n\n## Acknowledgements\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenocs%2Fclean-architecture-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenocs%2Fclean-architecture-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenocs%2Fclean-architecture-template/lists"}