A modular Scala 3 versioning toolkit - version types, parsing, manipulation, automatic derivation from Git, and build integration.

Cross-platform (JVM, Scala Native) with sbt integration and a CLI binary. Scala.js axis is deferred pending upstream sbt 2.x support.

Traditional versioning tools derive version numbers from repository history - counting commits since the last tag, appending distance suffixes, or inferring from branch patterns. This answers "how far are we from the last release?" but leaves the intended next version implicit.

version inverts this paradigm: developers declare the target version through commit message directives, and the system validates and enforces that intent. Snapshots represent pre-releases of the upcoming version, not post-release distances from a previous one.

Note: Requires sbt 2.x. Not compatible with sbt 1.x.

Add to project/plugins.sbt:

addSbtPlugin("africa.shuwari" % "sbt-version" % "0.7.0")

The plugin automatically derives and sets version for all projects.

//> using dep "africa.shuwari::version::0.7.0+15-46366051+20260517-0255"

import version.semver.*

// Parse
val v = SemVer.parse("2.1.0-rc.1+build.123") // Either[ParseError, SemVer]

// Construct
val release = SemVer(Major(1), Minor(2), Patch(3)) // 1.2.3

// Operations
release.next[Minor] // 1.3.0
release.as[Snapshot] // 1.2.3-SNAPSHOT
release.as[Alpha] // 1.2.3-alpha.1

Embed directives anywhere in commit messages to control versioning:

target: 2.5.0           # Set explicit target
version: major          # Increment major (1.2.3 -> 2.0.0)
version: minor          # Increment minor (1.2.3 -> 1.3.0)
version: patch          # Increment patch (1.2.3 -> 1.2.4)

Standalone shorthands (requires non-empty text after colon):

breaking: Remove deprecated API     # Major increment
feat: Add caching support           # Minor increment
fix: Handle edge case               # Patch increment

Apache 2.0