Environment Variables

Revola provides a set of environment variables at runtime that can be used within your configuration, templates, and scripts.

These variables are automatically injected during the release process and do not require manual setup.

Available Variables

`REVOLA_DATE`

The release date in ISO format (YYYY-MM-DD).

Example

REVOLA_DATE=2026-04-06

Used for

Changelog entries
Release notes

`REVOLA_DENO_PREVIOUS_VERSION`

The previous Deno (JSR) version before the current release.

Example

REVOLA_DENO_PREVIOUS_VERSION=1.1.0

Used for

JSR version comparison

`REVOLA_DENO_VERSION`

The version resolved for Deno (JSR) releases. Used when the 'deno' preset is enabled.

Example

REVOLA_DENO_VERSION=1.2.0

Used for

JSR publishing

`REVOLA_NODE_PREVIOUS_VERSION`

The previous Node.js (npm) version before the current release.

Example

REVOLA_NODE_PREVIOUS_VERSION=1.1.0

Used for

npm version comparison

`REVOLA_NODE_VERSION`

The version resolved for Node.js (npm) releases. Used when the 'node' preset is enabled.

Example

REVOLA_NODE_VERSION=1.2.0

Used for

npm publishing
package.json version

`REVOLA_PREVIOUS_VERSION`

The previous primary version before the current release.

Example

REVOLA_PREVIOUS_VERSION=1.1.0

Used for

Diff generation
Release comparison

`REVOLA_TAG`

The full Git tag created for the release, including any configured prefix.

Example

REVOLA_TAG=v1.2.0

Used for

Git tagging
CI workflows

`REVOLA_TAG_MAJOR`

The major version tag (e.g. v1). Useful for maintaining rolling major tags.

Example

REVOLA_TAG_MAJOR=v1

Used for

Major version aliasing

`REVOLA_TAG_MINOR`

The minor version tag (e.g. v1.2). Useful for maintaining rolling minor tags.

Example

REVOLA_TAG_MINOR=v1.2

Used for

Minor version aliasing

`REVOLA_VERSION`

The primary version being released. This value is resolved based on the active preset (e.g. node, deno, or git) and acts as the main version reference across the release.

Example

REVOLA_VERSION=1.2.0

Used for

Changelog titles
Commit messages
Default tag generation

Usage

These variables can be used inside your configuration or templates:

{
  "changelog": {
    "title": "{{REVOLA_VERSION}} ({{REVOLA_DATE}})"
  }
}

Revola replaces these placeholders at runtime with actual values.

How It Works

During a release, Revola will:

Calculate the next version
Generate metadata (date, tag, previous version)
Inject variables into the runtime environment
Resolve placeholders in config and templates