---
name: .NET CLI
description: |
.NET command-line tools for building, testing, and formatting. Common dotnet commands
and development workflow.
Keywords: dotnet build, dotnet restore, dotnet test, dotnet format, dotnet run,
NuGet, package restore, CLI commands, build system
---
# .NET CLI
## Prerequisites
- **.NET SDK 10.0**
- NuGet feeds defined in `NuGet.Config`
## Common Commands
### Restore Packages
```bash
dotnet restore
```
### Build Solution
```bash
dotnet build
```
### Run Tests
```bash
# All tests
dotnet test
# By test name
dotnet test --filter "FullyQualifiedName~CanCreateOrganization"
# By class name
dotnet test --filter "ClassName~OrganizationTests"
# By category/trait
dotnet test --filter "Category=Integration"
```
### Run Project
```bash
# Run the AppHost (recommended for full stack)
dotnet run --project src/Exceptionless.AppHost
# Run specific project
dotnet run --project src/Exceptionless.Web
```
### Format Code
```bash
# Format all C# files
dotnet format
# Check without making changes
dotnet format --verify-no-changes
```
## NuGet Configuration
Feeds are defined in [NuGet.Config](NuGet.Config) — do not add new sources unless explicitly requested.
## Directory.Build.props
Shared settings live in `src/Directory.Build.props`:
- Target framework versions
- Common package references
- Build properties
Keep changes consistent across the solution.
## Build Configurations
```bash
# Debug build (default)
dotnet build
# Release build
dotnet build -c Release
# Clean and rebuild
dotnet clean && dotnet build
```
## Watch Mode
```bash
# Run with hot reload
dotnet watch run --project src/Exceptionless.Web
```
## Package Management
```bash
# Add package to project
dotnet add package Foundatio
# Remove package
dotnet remove package OldPackage
# List packages
dotnet list package
# Check for outdated packages
dotnet list package --outdated
```
## Solution Management
```bash
# Build specific project
dotnet build src/Exceptionless.Core
# List projects in solution
dotnet sln list
```
## Environment Variables
```bash
# Set environment for run
ASPNETCORE_ENVIRONMENT=Development dotnet run --project src/Exceptionless.Web
```
## Troubleshooting
### Clean Restore
```bash
# Clear NuGet cache and restore
dotnet nuget locals all --clear
dotnet restore
```
### Verbose Build
```bash
dotnet build -v detailed
```
