jasontaylordev/CleanArchitecture

O que é?

Recursos principais

• 01Gera soluções com front-ends Angular, React ou apenas API usando dotnet new.
• 02Oferece suporte a SQLite, PostgreSQL e SQL Server como provedores de banco de dados.
• 03Organiza o código em projetos de domínio, aplicação, infraestrutura e web.
• 04Inclui MediatR, AutoMapper e FluentValidation para a lógica da aplicação.
• 05Executa localmente com o Aspire, cujo dashboard mostra as URLs e os logs do app.
• 06Vem com uma configuração de testes que usa NUnit, Shouldly, Moq e Respawn.

Casos de uso

• Começar um novo projeto ASP.NET Core empresarial que precisa de uma estrutura em camadas desde o início.
• Criar um backend de Web API integrado a um app de página única em Angular ou React.
• Aprender como a Clean Architecture é aplicada em uma base de código .NET.

Início rápido

1. 1

   Instale o template do .NET

   dotnet new install Clean.Architecture.Solution.Template
2. 2

   Crie uma nova solução com o framework cliente e o banco de dados de sua escolha

   dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName
3. 3

   Execute o app com o Aspire CLI (recomendado)

   aspire run

Antes de usar

• !É necessário ter o .NET 10.0 SDK ou posterior.
• !Para usar SQL Server ou PostgreSQL, é necessário ter o Docker Desktop ou o Podman.

Tópicos

Perguntas frequentes

O que é CleanArchitecture?

Um template de solução .NET que cria um app ASP.NET Core com Clean Architecture, com opções para Angular, React ou apenas API. Este template gera uma nova solução ASP.NET Core organizada com Clean Architecture, separando as camadas de domínio, aplicação, infraestrutura e web. Ao criar a solução com a CLI do dotnet, você escolhe o framework do cliente (Angular, React ou nenhum, para usar apenas a API) e o provedor de banco de dados (SQLite por padrão, ou PostgreSQL e SQL Server).

CleanArchitecture é gratuito? Qual é a licença?

CleanArchitecture é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

CleanArchitecture ainda é mantido?

Manutenção ativa. O último commit de CleanArchitecture foi em 21 de out. de 2026.

Para que posso usar CleanArchitecture?

Começar um novo projeto ASP.NET Core empresarial que precisa de uma estrutura em camadas desde o início. Criar um backend de Web API integrado a um app de página única em Angular ou React. Aprender como a Clean Architecture é aplicada em uma base de código .NET.

Como instalar CleanArchitecture?

Instale o template do .NET: dotnet new install Clean.Architecture.Solution.Template Crie uma nova solução com o framework cliente e o banco de dados de sua escolha: dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName Execute o app com o Aspire CLI (recomendado): aspire run

Onde consigo CleanArchitecture?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jasontaylordev/CleanArchitecture