DotMR.Cli 0.0.13

DotMR - .NET Monorepo Management Framework

DotMR is a first-class monorepo management framework for .NET 10+, designed to handle large, multi-project codebases through graph awareness, incremental builds, and policy-driven orchestration.

Installation

Install DotMR as a global .NET tool:

dotnet tool install --global DotMR.Cli

Or update an existing installation:

dotnet tool update --global DotMR.Cli

Quick Start

# Initialize a new monorepo
dotmr init

# Generate new projects from templates
dotmr g app MyApp              # Create console application
dotmr g lib MyLib              # Create class library
dotmr g test MyLib -r MyLib    # Create test project with reference

# Build affected projects based on git changes
dotmr build --affected

# Build with parallel execution
dotmr build --parallel 8

# Preview execution plan without building
dotmr build --plan

# Generate a solution filter for focused development
dotmr slnf create --project MyProject.Api --mode both

# View dependency graph
dotmr graph --project MyProject.Core

# Run tests only for affected projects
dotmr test --affected

# Run tests in parallel without rebuilding
dotmr test --parallel 4 --no-build

Key Features

• Dependency Graph Management - Full graph builder using Microsoft.Build.Graph with CLI queries and visualization
• Incremental Builds & Caching - Input hashing, build output caching, and remote cache providers (Azure Blob, NFS)
• Task Orchestration - Parallel, dependency-aware task runner integrated with dotnet
• Solution Filters - Automatic .slnf generation for working efficiently with subsets of large repositories
• Policy Engine - Repository structure validation and configuration consistency checks
• Testing & Coverage - Sharded testing with parallel execution and impact-based selection
• Change Detection - dotmr affected uses Git diff and dependency graph traversal
• Telemetry & Metrics - Performance reports with JSON, Prometheus, and Application Insights export

Requirements

• .NET SDK: 10.0 or newer
• Solution format: .slnx (primary), .slnf (generated filters)
• Operating systems: Windows, Linux, macOS

Documentation

For detailed usage and documentation, visit:

• GitHub Repository: https://github.com/CRidge/dotmr
• CLI Usage Guide: https://github.com/CRidge/dotmr/blob/main/docs/CLI_USAGE.md
• Architecture: https://github.com/CRidge/dotmr/blob/main/ARCHITECTURE.md

Project Status

DotMR is currently in active development. Core features like graph engine, build orchestration, testing, caching, and CLI are implemented and functional. Some advanced features are still in progress.

Contributing

Contributions and feedback are welcome! Visit the GitHub repository to:

• Report issues or bugs
• Request new features
• Submit pull requests
• Read the contributing guide

License

MIT License - See LICENSE for details.

DotMR is not a replacement for MSBuild or Visual Studio — it is the missing orchestration and intelligence layer that makes large .NET repositories fast, structured, and future-proof.