ReleaseGen 0.3.0
See the version list below for details.
dotnet tool install --global ReleaseGen --version 0.3.0
dotnet new tool-manifest
dotnet tool install --local ReleaseGen --version 0.3.0
#tool dotnet:?package=ReleaseGen&version=0.3.0
nuke :add-package ReleaseGen --version 0.3.0
ReleaseGen
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 ReleaseGen -g
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:
initis 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'sbuild.presetkey.runis 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; every stage command and run also accept
--dry-run and --verbose (which contradict --quiet); exit code is 0 on success and 1
on any failure. See the command reference for flags and behavior.
Documentation
- Changelog
- Command reference
- Manifest schema
- Build presets
- Single-file rules
- Trusted publishing in CI
- Stage handoff contract
- Glossary
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 | Versions 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. |
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 |
# Changes since 0.2.0
## Added
- **`--skip-duplicate` on `publish`** — an opt-in flag, forwarded to every `dotnet nuget push` for the run, that lets the feed itself decide whether a package is a duplicate. When a push exits zero and reports the skip marker, it counts as skipped rather than pushed: the stage logs a note naming the package and source, and the closing summary shows pushed and skipped as two separate totals while still exiting 0. Any other nonzero exit fails the stage as before. Without the flag and without a manifest key, behaviour is unchanged: a duplicate still fails the stage.
- **`skipDuplicates` in the manifest** — set it in the publish section to make skipping your standing behaviour, so you don't have to pass the flag each time. It's absent by default, and the flag always wins over the manifest when both are given, with at most one conflict warning per run.
- **`--skip-duplicate` on `releasegen run`** — the chained run passes the flag along to publish, so a chain and a standalone `releasegen publish` resolve the same decision. Omitting the flag forwards nothing and leaves the run on today's default; `--skip-duplicate` (or `=true`) turns skipping on, and `--skip-duplicate=false` keeps "declared off" distinct from "not specified".
## Changed
- Updated System.CommandLine to 2.0.14, Microsoft.Extensions.DependencyInjection (and Abstractions) to 10.0.14, and Meziantou.Analyzer to 3.0.318.
- Docs for commands, manifest schema, and the glossary now cover the duplicate-push behaviour and the pushed/skipped summary.