dotnet/Nerdbank.GitVersioning

Health v2 · maintenance only

Adoption not part of the score

1585 stars · 186 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A .NET library and CLI tool that generates unique, semver-compatible version numbers for assemblies and packages from a single version.json file, derived from git commit history. It integrates with MSBuild and NPM to automatically stamp builds and provides runtime access to version info via a generated ThisAssembly class.

Use cases

• automatically version .NET assemblies from git history
• generate unique semver versions for every commit without tags
• stamp NuGet and npm packages with build versions
• embed git commit IDs in non-official builds
• backtrack from a computed version to its source git commit
• make builds reproducible without depending on git tags or branch names

When to choose

• you build .NET projects and want automatic, deterministic versioning from git
• you need unique versions per commit for reproducible CI builds
• you want version info available at runtime in your assemblies
• you publish NuGet or npm packages and need consistent version stamping

When to avoid

• your project is not .NET-based and you don't need the npm integration
• you prefer tag-driven or branch-name-driven versioning schemes
• you need a language-agnostic versioning solution outside MSBuild/gulp ecosystems

Facets

library · maturity active

build-tool version-control cli developer-tools developer-tools version-control cross-platform dotnet cli semantic-versioning msbuild nuget npm git version-stamping ci-cd build-reproducibility devops nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="dotnet/Nerdbank.GitVersioning")