Calaf 2025.6.14

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet tool install --global Calaf --version 2025.6.14
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local Calaf --version 2025.6.14
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=Calaf&version=2025.6.14
                    


                    

                
nuke :add-package Calaf --version 2025.6.14

Build Solution

Calaf

Calaf is a command-line tool for managing Calendar Versioning (CalVer) of .NET projects, written in F#.

Features

  • Automatic versioning based on current date
  • Support for stable and nightly builds
  • Works with csproj/fsproj projects formats
  • Tool installation via dotnet CLI

Requirements

  • .NET 8.0 or later

Versioning Scheme

The current supported scheme has a format:

Component part Build Example Required
Year YYYY 2025 ✅
Month MM 1, 12 ✅
Patch PATCH 1, 2, 999 ❌
Build BUILD.DAY.NUMBER nightly.15.1 ❌

YYYY - A year of the version. Always required.

MM - A month of the version. Always required.

PATCH - A patch number in the version's month.

BUILD.DAY.NUMBER - A type of the build with the day of the month, and number of the build in this day.

Currently available type of the build is: nightly

Installation

dotnet tool install -g Calaf

Getting Started

  1. Add init version to your projects files:
<PropertyGroup>
    <Version>2025.6</Version>
</PropertyGroup>
  1. Manage project versioning using Calaf:
# Create stable version (e.g., 2025.6 → 2025.6.1)
calaf make stable

Updates the project version to a stable Calendar Version based on the current UTC date.

# Create nightly build (e.g., 2025.6 → 2025.6.1-nightly.30.1)
calaf make nightly

Updates the project version to a nightly build version based on the current date and day of the month.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2025.7.0-beta.1 0 7/21/2025
2025.6.14 154 6/30/2025
2025.6.13 130 6/30/2025