create-dotnet-stack 1.1.0

create-dotnet-stack

create-dotnet-stack is a .NET global tool for generating .NET 10 Web API solutions with clear architecture options, tested sample features, container support, and secure-by-default project artifacts.

Requirements

• .NET SDK 10.0.100 or a compatible newer feature band
• Docker, optionally, for generated compose environments

Install from source

dotnet pack --configuration Release
dotnet tool install --global --add-source ./nupkg create-dotnet-stack

Usage

Run without arguments to use the interactive prompts:

create-dotnet-stack

For repeatable automation, pass explicit options:

create-dotnet-stack \
  --name MyApp \
  --arch clean \
  --api minimal \
  --orm efcore \
  --db postgres \
  --with-docker true \
  --ci github \
  --tests xunit \
  --centralPackages true

Use create-dotnet-stack --help for the full option reference. Project names are intentionally restricted to C#-safe identifiers (letters, numbers, and underscores) to prevent unsafe output paths and invalid generated namespaces.

Generated defaults

• basic, clean, and microfeature architectures
• Minimal APIs or MVC controllers for every architecture
• EF Core or Dapper across PostgreSQL, SQL Server, and MySQL
• Built-in OpenAPI, problem details, health endpoint, nullable reference types, analyzers, and warnings-as-errors
• Unit tests using xUnit, NUnit, or MSTest
• Optional Central Package Management, Docker Compose, and GitHub Actions

Generation runs restore, a Release build, and tests before publishing the output directory, so a failed generation never leaves a partial destination behind.

The sample Users feature is in-memory by design, so a new project can run without database credentials. Selecting an ORM also produces provider-specific persistence registration and primitives ready for a real feature; configure ConnectionStrings__Default before using that persistence layer.

Development

dotnet build
dotnet run -- --help

License

MIT