Compare Entity Framework Core migrations between Git branches - detect conflicts, preview schema changes, and block bad merges before they hit production.

# Clone the repository
git clone https://github.com/Sarmkadan/ef-migration-diff.git
cd ef-migration-diff

# Build and install
dotnet build -c Release
dotnet publish -c Release -o ./publish
dotnet tool install --global --add-source ./publish ef-migration-diff

# Compare migrations between two branches
ef-migration-diff compare main feature/add-users

# Validate migration files on the current branch
ef-migration-diff validate

# Generate HTML side-by-side visual diff
ef-migration-diff visual-diff main feature/add-users

# Show migration dependency graph
ef-migration-diff graph

# Suggest auto-merge resolutions for conflicts
ef-migration-diff auto-merge main feature/add-users

For more practical usage, including programmatic access and DI integration, check the examples directory:

• BasicUsage.cs: Simple setup and migration comparison.
• AdvancedUsage.cs: Custom configuration and error handling.
• IntegrationExample.cs: Dependency injection setup for ASP.NET applications.
• basic-comparison.cs: Git branch comparison.
• conflict-detection.cs: Detailed conflict analysis.

To run the tool using Docker, you can use the provided docker-compose.yml file:

# Build and run the tool
docker-compose run --rm ef-migration-diff compare main feature/add-users

The Docker image includes git and the necessary dependencies to run the tool against your local repository.

The project includes comprehensive performance benchmarks using BenchmarkDotNet to measure throughput and memory allocation for core operations.

To run all benchmarks:

cd ef-migration-diff.Benchmarks
# Run all benchmarks and save results to BenchmarkDotNet.Artifacts
dotnet run -c Release

# Run with specific filter
dotnet run -c Release -- --filter *"

To run benchmarks and export results to a file:

cd ef-migration-diff.Benchmarks
# Export to markdown
dotnet run -c Release -- --exporters markdown --filter *"

# Export to csv
dotnet run -c Release -- --exporters csv --filter *"

To compare performance between different configurations:

cd ef-migration-diff.Benchmarks
# Run config comparison benchmarks
dotnet run -c Release -- --filter ConfigComparisonBenchmarks"

To run memory allocation benchmarks:

cd ef-migration-diff.Benchmarks
dotnet run -c Release -- --filter MemoryBenchmarks"

The benchmarks measure:

• Throughput: Operations per second for critical methods
• Memory Allocation: GC pressure and memory usage
• Configuration Impact: Performance characteristics with different options

Key benchmarks include:

• Two-way diff computation (ComputeDiff)
• Three-way diff computation (ComputeThreeWayDiff)
• Merge resolution strategies (AcceptSource, AcceptTarget, AutoMerge)
• Validation operations (ValidateResolution)

1. Small datasets (10-50 changes): Typical for individual migrations

2. Medium datasets (100-500 changes): Typical for feature branches

3. Large datasets (1000+ changes): Enterprise applications with many migrations

4. Configuration variations:

   • Default options
   • With SQL content included
   • With whitespace normalization
   • With metadata display

The library is optimized for:

• Low memory allocation: Minimal GC pressure during diff computation
• Fast execution: O(n log n) complexity for most operations
• Scalability: Handles large migration sets efficiently

Note: Actual performance varies based on hardware, .NET runtime version, and specific schema change patterns. These benchmarks were run on a modern developer workstation with .NET 10.0.

The library maintains low memory allocation through:

• Efficient data structures (List, Dictionary<K,V>)
• Minimal intermediate object creation
• Reuse of buffers where possible
• Streaming-friendly algorithms for large datasets

This project is licensed under the MIT License - see the LICENSE file for details. Copyright (c) 2026 Vladyslav Zaiets.