Repolode
jasontaylordev

jasontaylordev/CleanArchitecture

Plantilla de solución .NET que crea una aplicación ASP.NET Core con Clean Architecture y opciones para Angular, React o solo API.

Estrellas
20,651
Forks
4,291
Issues abiertos
9
Último commit
hace 12 horas

¿Qué es?

Esta plantilla genera una nueva solución ASP.NET Core con una estructura basada en Clean Architecture, que separa las capas de dominio, aplicación, infraestructura y web. Al crear la solución con la CLI de dotnet, eliges un framework de cliente (Angular, React o ninguno, si solo quieres una API) y un proveedor de base de datos (SQLite de forma predeterminada, o PostgreSQL y SQL Server).

El proyecto generado usa Entity Framework Core para el acceso a datos, MediatR para gestionar solicitudes, AutoMapper y FluentValidation para la asignación de datos y la validación, y Scalar para la documentación de la API. Las pruebas están configuradas con NUnit, Shouldly, Moq y Respawn. Aspire coordina la aplicación y sus dependencias durante el desarrollo local.

La plantilla se distribuye como paquete NuGet y tiene versiones asociadas a cada lanzamiento de .NET, con ramas disponibles para versiones anteriores de .NET.

Funciones clave

  • 01Genera soluciones con Angular, React o solo API mediante dotnet new.
  • 02Admite SQLite, PostgreSQL y SQL Server como proveedores de base de datos.
  • 03Organiza el código en proyectos de dominio, aplicación, infraestructura y web.
  • 04Incluye MediatR, AutoMapper y FluentValidation para la lógica de la aplicación.
  • 05Permite ejecutar la solución localmente con Aspire, cuyo panel muestra las URL y los registros de la aplicación.
  • 06Incluye una configuración de pruebas con NUnit, Shouldly, Moq y Respawn.

Casos de uso

  • Iniciar un nuevo proyecto empresarial de ASP.NET Core que necesite una estructura por capas desde el primer día.
  • Crear una API web backend junto con una aplicación de página única en Angular o React.
  • Aprender cómo se aplica Clean Architecture en una base de código .NET.

Inicio rápido

  1. 1

    Instala la plantilla de .NET

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

    Crea una nueva solución con el framework de cliente y la base de datos que elijas

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

    Ejecuta la aplicación con Aspire CLI (recomendado)

    aspire run

Antes de usarlo

  • Se requiere .NET 10.0 SDK o una versión posterior.
  • Para usar SQL Server o PostgreSQL, se necesita Docker Desktop o Podman.

Temas

Preguntas frecuentes

¿Qué es CleanArchitecture?
Plantilla de solución .NET que crea una aplicación ASP.NET Core con Clean Architecture y opciones para Angular, React o solo API. Esta plantilla genera una nueva solución ASP.NET Core con una estructura basada en Clean Architecture, que separa las capas de dominio, aplicación, infraestructura y web. Al crear la solución con la CLI de dotnet, eliges un framework de cliente (Angular, React o ninguno, si solo quieres una API) y un proveedor de base de datos (SQLite de forma predeterminada, o PostgreSQL y SQL Server).
¿CleanArchitecture es gratuito? ¿Qué licencia tiene?
CleanArchitecture es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿CleanArchitecture sigue mantenido?
Mantenimiento activo. El último commit de CleanArchitecture fue el 21 oct 2026.
¿Para qué puedo usar CleanArchitecture?
Iniciar un nuevo proyecto empresarial de ASP.NET Core que necesite una estructura por capas desde el primer día. Crear una API web backend junto con una aplicación de página única en Angular o React. Aprender cómo se aplica Clean Architecture en una base de código .NET.
¿Cómo se instala CleanArchitecture?
Instala la plantilla de .NET: dotnet new install Clean.Architecture.Solution.Template Crea una nueva solución con el framework de cliente y la base de datos que elijas: dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName Ejecuta la aplicación con Aspire CLI (recomendado): aspire run
¿Dónde consigo CleanArchitecture?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jasontaylordev/CleanArchitecture

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados