# Semantic Versions > A living versioning specification, and a proposal for Semantic Versioning 3.0.0. It restores build metadata to version precedence, defines grammars for ranges, comparators and sets, and layers three extensions that encode build variants, artifact integrity and whole resolved dependency graphs inside a version string. A version here is source-qualified and its build metadata is meaningful, not inert: `npm:sharp@0.33.0+linux.x64.musl.sha512.a91c…` names a registry, a package, a SemVer core, a target platform and the exact bytes. The Markdown linked below is normative. https://semver.xyz/spec/ is rendered directly from the core specification, so the two never differ. The extension pages are separately authored presentations of their Markdown; where an extension page and its Markdown disagree, the Markdown governs. Every page of the site is also available as Markdown: add `.md` to its path (https://semver.xyz/faq.md), or request the page with an `Accept: text/markdown` header. Every page also answers with an Affordances graph (https://www.affordances.sh) when requested with `Accept: application/vnd.affordances+json`: what it shows, actions to call, and where to go next. The range selector's actions (`select`, `desugar`, `parse`, `compare`, `bump`) run the reference parser, the spec's `readSection` returns one section as Markdown, and the grammars' `readGrammar` returns a BNF. The site index is at https://semver.xyz/.well-known/affordances.json. The site is also an MCP server at https://semver.xyz/mcp (streamable HTTP, no auth: `claude mcp add --transport http semver https://semver.xyz/mcp`), with the same two tools `npx @affordances/mcp https://semver.xyz` gives. See https://semver.xyz/agents/. ## Specification - [Semantic Versions 1.0.0](https://semver.xyz/spec/SPEC.md): The core specification: versions, precedence, sets, ranges, comparators, operators and channels. Normative; https://semver.xyz/spec/ is rendered from this file. - [VERSION.bnf](https://semver.xyz/spec/VERSION.bnf): Grammar for a single version. - [RANGE.bnf](https://semver.xyz/spec/RANGE.bnf): Grammar for ranges. - [COMPARATOR.bnf](https://semver.xyz/spec/COMPARATOR.bnf): Grammar for comparators. - [REFERENCE.bnf](https://semver.xyz/spec/REFERENCE.bnf): Grammar for source-qualified references. - [VARIANTS.bnf](https://semver.xyz/spec/VARIANTS.bnf): Grammar for Build Variants coordinates. - [INTEGRITY.bnf](https://semver.xyz/spec/INTEGRITY.bnf): Grammar for Package Integrity digests. ## Extensions - [Build Variants](https://semver.xyz/extensions/variants/variants.md): Encodes os/arch/abi/feature coordinates as build metadata, e.g. `1.0.0+linux.x64.musl`, so one version can address a target matrix. - [Package Integrity](https://semver.xyz/extensions/integrity/integrity.md): Carries a content-addressable digest inside the version, e.g. `1.0.0+sha512.`, pinning exact bytes. - [Dependency Locks](https://semver.xyz/extensions/dependency-locks/dependency-locks.md): Attaches a resolved transitive subgraph to a version as `+lock.`. Start here; the full spec is under Optional. ## Libraries - [semantic-versions (npm)](https://semver.xyz/parser.md): The reference parser: parse, validate, compare and range-match, with build metadata participating in precedence. - [All libraries](https://semver.xyz/libraries/): Implementations for JavaScript, Rust, Python, Go, Ruby, Java, .NET and PHP that pass the same conformance suite, with install commands and benchmarks against each language's existing libraries. ## Optional - [Dependency Locks — full specification](https://semver.xyz/extensions/dependency-locks/dependency-locks-spec.md): ~20k words. Binary format, canonical encoding, validation, threat model, and a measured fidelity audit against real npm/pnpm/yarn/vlt/uv lockfiles. Fetch only when you need the wire format. - [llms-full.txt](https://semver.xyz/llms-full.txt): The core specification and all three extension overviews concatenated into one file, for a single-fetch read. - [Source repository](https://github.com/vltpkg/semantic-versions): Specification sources, the reference parser, and the site. ## Pages - [Semantic Versions](https://semver.xyz/index.md) - [Specification](https://semver.xyz/spec.md) - [Proposal: Semantic Versioning 3.0.0](https://semver.xyz/proposal.md) - [BNF grammars](https://semver.xyz/grammar.md) - [Range selector (interactive)](https://semver.xyz/selector.md) - [History: a short history of Semantic Versioning](https://semver.xyz/origin.md) - [FAQ](https://semver.xyz/faq.md) - [Libraries: implementations for JavaScript, Rust, Python, Go, Ruby, Java, .NET and PHP, with benchmarks](https://semver.xyz/libraries.md) - [Extensions index](https://semver.xyz/extensions.md) - [Build Variants](https://semver.xyz/extensions/variants.md) - [Package Integrity](https://semver.xyz/extensions/integrity.md) - [Dependency Locks](https://semver.xyz/extensions/dependency-locks.md) - [License](https://semver.xyz/license.md) - [For agents: llms.txt, Markdown twins, the Affordances graph and MCP](https://semver.xyz/agents.md)