dotnet-forge

CLI to scaffold and standardize .NET projects. It creates a solution with a Clean Architecture structure and can optionally add tests, Docker files, and DocFx tooling.

Features

• forge new and forge doctor commands
• Clean Architecture project layout (Domain/Application/Infrastructure/API)
• Optional Docker scaffolding via --docker
• Optional test project via --test
• Optional DocFx tooling via --documentation

Requirements

• .NET SDK 8+
• Node.js 18+ (for running the CLI)
• Git (recommended)
• Docker Desktop (optional, for --docker)

Install

From npm:

npm install -g dotnet-forge

From the repo:

npm install
npm link

Then use forge from anywhere.

Usage

forge doctor

forge new MyApp

forge new MyApp --test

forge new MyApp --test nunit --docker --documentation

Commands

forge new <name>

• Creates a solution in a new folder named <name>
• Uses the Clean Architecture template by default
• Optional -t, --test [framework] to add tests (xunit, nunit, mstest; default is xunit when omitted)
• Optional -d, --docker to generate Dockerfile and docker-compose.yml
• Optional -docs, --documentation to add DocFx tooling

forge doctor

• Checks for .NET SDK, Git, and Docker

Project Structure

forge new creates:

• src/<Name>.Domain
• src/<Name>.Application
• src/<Name>.Infrastructure
• src/<Name>.Api

It also adds solution references and basic folders for each layer.

Development

npm test
npm run lint
npm run format

License

MIT