{"id":18304,"library":"ember-cli-release","title":"ember-cli-release","description":"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.","status":"active","version":"1.0.0-beta.2","language":"javascript","source_language":"en","source_url":"https://github.com/lytics/ember-cli-release","tags":["javascript","ember-addon","ember-cli","release","git","tag"],"install":[{"cmd":"npm install ember-cli-release","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-release","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-release","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM import works; CommonJS require may not resolve correctly in Ember CLI contexts. Used as an addon, not typically imported directly.","wrong":"const ReleaseCommand = require('ember-cli-release')","symbol":"default","correct":"import ReleaseCommand from 'ember-cli-release'"},{"note":"The addon is installed via `ember install`, not generated. The `release` command is invoked via `ember release`.","wrong":"ember install ember-cli-release","symbol":"release","correct":"ember generate release"},{"note":"Config file generated on install. Exports a plain object with options; no specific import needed.","wrong":null,"symbol":"config/release.js","correct":"// config/release.js\nmodule.exports = { /* options */ };"}],"quickstart":{"code":"// 1. Install as Ember addon\nember install ember-cli-release\n\n// 2. (Optional) Configure in config/release.js\n// 3. Run release command:\n// Automatically increment patch version, commit, tag, push\nember release\n\n// Increment minor version:\nember release --minor\n\n// Annotated tag with custom message:\nember release --annotation \"Release %@\"","lang":"javascript","description":"Shows installation, basic release with patch bump, minor bump, and annotated tag usage."},"warnings":[{"fix":"Migrate to release-it: npm install -D release-it; configure .release-it.json","message":"ember-cli-release is in beta and has not seen updates since 2016. Consider using release-it or standard-version.","severity":"deprecated","affected_versions":">=1.0.0-beta.2"},{"fix":"Do not use `premajor`; use `major` with manual prerelease identifier if needed.","message":"The `premajor` option in config does nothing because it's always ignored as per docs.","severity":"gotcha","affected_versions":">=1.0.0-beta.2"},{"fix":"Set `manifest: ['package.json']` in config/release.js or on CLI.","message":"If your project lacks a `bower.json`, the default manifest list will cause an error.","severity":"breaking","affected_versions":">=1.0.0-beta.2"},{"fix":"Use with caution; consider explicitly confirming with CI or dry-run.","message":"The `--yes` option skips all confirmation prompts including dangerous operations like publishing.","severity":"gotcha","affected_versions":">=1.0.0-beta.2"},{"fix":"Remove bower.json from project or set manifest: ['package.json']","message":"Bower support is deprecated; `bower.json` handling will likely be removed in future versions.","severity":"deprecated","affected_versions":">=1.0.0-beta.2"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Create an initial tag manually: git tag v0.1.0","cause":"No git tags exist or no tags match SemVer pattern (e.g., v1.0.0).","error":"ember release: Could not find any valid SemVer tags"},{"fix":"Install Git or add to system PATH.","cause":"Git is not installed or not in PATH.","error":"Error: spawn git ENOENT"},{"fix":"Set manifest: ['package.json'] in config/release.js","cause":"Default manifest includes bower.json but project doesn't have it.","error":"Release error: `bower.json` not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}