ReleaseGen 0.1.0-alpha.0

This is a prerelease version of ReleaseGen.
There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global ReleaseGen --version 0.1.0-alpha.0
                    
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 ReleaseGen --version 0.1.0-alpha.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=ReleaseGen&version=0.1.0-alpha.0&prerelease
                    
nuke :add-package ReleaseGen --version 0.1.0-alpha.0
                    

ReleaseGen

CI License: MPL-2.0

ReleaseGen is an opinionated .NET CLI for building, packaging, and publishing .NET projects. One strict releasegen.json manifest drives every stage of a release: build, test, package, and publish.

Install

dotnet tool install -g ReleaseGen

Requires the .NET 10 SDK. The tool command is releasegen. Running bare releasegen prints command help; no stage executes without an explicit verb.

Quickstart

# 1. Write a minimal releasegen.json in the current directory
releasegen init

# 2. Edit releasegen.json: name your targets (projects and their artifact kinds),
#    declare runtimeIdentifiers, and optionally add test and publish sections

# 3. Run the pipeline the manifest names, in manifest order
releasegen run

Notes:

  • init is a one-shot command and takes no part in the chained run. It refuses to overwrite an existing manifest unless you pass --overwrite; --preset <name> seeds the manifest's build.preset key.
  • run is the chained run: it executes the stages the manifest names - build always, test when a test section is declared, package and publish when targets declare package kinds - in manifest order, aborting at the first failed stage and noting each skipped stage. The test outcome is carried to publish, so tests never run twice.
  • Each stage is also its own command - releasegen build, releasegen test, releasegen package, releasegen publish - and all of them share the same manifest, discovered by walking up from the current directory.

Build output stays local under a release/ directory; the only network destination is the publish stage's NuGet source. Publishing is gated on your tests: a manifest declaring a test section blocks publish when that stage fails.

Commands

Command Purpose
init Write a minimal manifest (one-shot)
build Publish release binaries per target and runtime identifier
test Run the projects the manifest's test section names
package Pack the package kinds each target declares
publish Push packages to NuGet sources (test-gated)
run Chained run of the stages above, in manifest order

Every command accepts the global --quiet flag; exit code is 0 on success and 1 on any failure. See the command reference for flags and behavior.

Documentation

What ReleaseGen isn't

  • A changelog or release notes generator/formatter.
  • A test coverage checker.
  • An artifact uploader: ReleaseGen writes release binaries and archives to a local release/ directory and performs no upload of them.
  • A token broker: ReleaseGen performs no OIDC token acquisition; see the trusted publishing page for the CI-side procedure.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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
0.4.0 94 11/9/2026
0.3.0 102 11/4/2026
0.2.0 113 11/1/2026
0.1.0-alpha.0 75 10/25/2026

Initial Release