ember-cli-release

1.0.0-beta.2 verified Sat Apr 25 auth: no javascript

Ember CLI addon (v1.0.0-beta.2) for managing release versions via git tags. Provides an `ember release` command that bumps version in package.json and bower.json, commits, tags, and pushes. Supports SemVer and date-based strategies, custom hooks, annotated tags, and NPM publishing. Streamlined alternative to `npm version` with Ember-specific integration. Release cycle is slow; beta for years. Key differentiator: non-SemVer strategies and Ember addon ecosystem integration.

Common errors

error ember release: Could not find any valid SemVer tags ↓

cause No git tags exist or no tags match SemVer pattern (e.g., v1.0.0).

fix

Create an initial tag manually: git tag v0.1.0

error Error: spawn git ENOENT ↓

cause Git is not installed or not in PATH.

fix

Install Git or add to system PATH.

error Release error: `bower.json` not found ↓

cause Default manifest includes bower.json but project doesn't have it.

fix

Set manifest: ['package.json'] in config/release.js

Warnings

deprecated ember-cli-release is in beta and has not seen updates since 2016. Consider using release-it or standard-version. ↓

fix Migrate to release-it: npm install -D release-it; configure .release-it.json

gotcha The `premajor` option in config does nothing because it's always ignored as per docs. ↓

fix Do not use `premajor`; use `major` with manual prerelease identifier if needed.

breaking If your project lacks a `bower.json`, the default manifest list will cause an error. ↓

fix Set `manifest: ['package.json']` in config/release.js or on CLI.

gotcha The `--yes` option skips all confirmation prompts including dangerous operations like publishing. ↓

fix Use with caution; consider explicitly confirming with CI or dry-run.

deprecated Bower support is deprecated; `bower.json` handling will likely be removed in future versions. ↓

fix Remove bower.json from project or set manifest: ['package.json']

Install

npm install ember-cli-release

yarn add ember-cli-release

pnpm add ember-cli-release

Imports

default
wrong
```
const ReleaseCommand = require('ember-cli-release')
```
correct
```
import ReleaseCommand from 'ember-cli-release'
```
ESM import works; CommonJS require may not resolve correctly in Ember CLI contexts. Used as an addon, not typically imported directly.
release
wrong
```
ember install ember-cli-release
```
correct
```
ember generate release
```
The addon is installed via `ember install`, not generated. The `release` command is invoked via `ember release`.
config/release.js
```
// config/release.js
module.exports = { /* options */ };
```
Config file generated on install. Exports a plain object with options; no specific import needed.

Quickstart

Shows installation, basic release with patch bump, minor bump, and annotated tag usage.

// 1. Install as Ember addon
ember install ember-cli-release

// 2. (Optional) Configure in config/release.js
// 3. Run release command:
// Automatically increment patch version, commit, tag, push
ember release

// Increment minor version:
ember release --minor

// Annotated tag with custom message:
ember release --annotation "Release %@"