Skip to content

This dotnet-new template for .NET Back-ends increases productivity on building applications with the Hexagonal, Clean or Event Sourcing architectures styles. This tool generates a .NET back-end with built-in best practices in 15 seconds!

License

Notifications You must be signed in to change notification settings

x3nx1a/dotnet-new-caju

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Caju Caju: .NET apps with awesome architectures!

Service Template to help you build evolvable and maintainable applications. It follows the principles from the Clean Architecture book and built on Domain-Driven Design. This tool increases productivity on developing your next microservices.

dotnet new caju

Generate your own awesome Back-end!

NuGet Build Status Gitter

To generate your own awesome .NET Back-end simple run:

dotnet new -i Paulovich.Caju::0.6.0
dotnet new clean

The Architecture Styles

We prevent our software to be coupled from technology details like User Interface, Data Access frameworks, Service Bus or Web Servers. And there are some concepts that guided us:

  • Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases.
  • The SOLID principles are all over the the solution.
  • The software implementation is agnostic from technology, framework, or database. The result is focus on the use cases with input/output ports.
  • Designed around the Business Domain, having Continous Delivery and Independent Deployment.

Sample applications

Run dotnet new -i Paulovich.Caju then try the following commands.

Clean Architecture Solution with basic use cases:

dotnet new clean --use-cases basic

Hexagonal Architecture Solution with all use cases:

dotnet new hexagonal --use-cases full

Empty Event-Sourcing Solution:

dotnet new eventsourcing --use-cases empty

For olher solution types check out the Caju Samples folder.

Switches

There are switches to generate your awesome application with your needs. Try after dotnet new clean or dotnet new hexagonal or dotnet new eventsourcing:

  • --use-cases full basic readonly none
  • --user-interface webapi none
  • --data-access mongo entityframework dapper none
  • --service-bus kafka none
  • --tips true false
  • --skip-restore true false

Use the switch --help for the complete list of options.

Roadmap

  • Allow to choose the architecture style
  • Allow to choose the built-in use cases sets
    • Full set of use cases ✅
    • Basic set of use cases ✅
    • Read Only ✅
    • None ✅
  • Allow to choose the data access frameworks
    • MongoDB ✅
    • Dapper ✅
    • Entity Framework Core ✅
    • Azure Cosmos DB
    • NHibernate Core
    • InMemory ✅
    • None ✅
  • Allow to choose the UI frameworks
    • Both
    • WebAPI ✅
    • Console
    • None ✅
  • Allow to choose the Service Bus frameworks
    • Kafka ✅
    • Azure Event Bus
    • None ✅
  • Allow to skip the dotnet restore after code generation ✅
  • Allow to include or to remove the architecture tips

Common Issues

Check your .NET Core SDK. Our features are only supported in 2.1.4 SDK or plus.

$ dotnet --version
2.1.4

About

This dotnet-new template for .NET Back-ends increases productivity on building applications with the Hexagonal, Clean or Event Sourcing architectures styles. This tool generates a .NET back-end with built-in best practices in 15 seconds!

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 99.3%
  • Other 0.7%