{"id":16988,"library":"ember-cli-deploy-display-revisions","title":"Ember CLI Deploy Display Revisions","description":"ember-cli-deploy-display-revisions is an Ember CLI Deploy plugin designed to list and display deployed revisions for Ember applications. Its current stable version is 3.0.0. This plugin integrates directly with the ember-cli-deploy ecosystem, providing a CLI command (`ember deploy:list`) to show recent deployments. It allows configuration of the number of revisions to display and expects revision data to be provided by other index plugins (e.g., fetchRevisions) in a specific JSON format, including details like `revision`, `version`, `timestamp`, `deployer`, and `active` status. The plugin is primarily a Node.js-only addon, meaning it does not participate in typical Ember application build or test processes, distinguishing it from front-end focused Ember addons. Release cadence is driven by updates to core dependencies like Node.js and ember-cli-deploy itself.","status":"active","version":"3.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/ember-cli-deploy/ember-cli-deploy-display-revisions","tags":["javascript","ember-addon","ember-cli-deploy-plugin"],"install":[{"cmd":"npm install ember-cli-deploy-display-revisions","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-deploy-display-revisions","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-deploy-display-revisions","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core dependency for the Ember CLI Deploy ecosystem; this package is a plugin for it.","package":"ember-cli-deploy","optional":false}],"imports":[{"note":"This is an Ember CLI addon, primarily integrated via the `ember install` command. Direct JavaScript module imports into application code are not the typical use case.","wrong":"import 'ember-cli-deploy-display-revisions'; // Not a direct JS module import","symbol":"Installation","correct":"ember install ember-cli-deploy-display-revisions"},{"note":"The core functionality is exposed through the Ember CLI `deploy:list` command. It takes an environment argument and an optional `--amount` flag.","wrong":"require('ember-cli-deploy-display-revisions'); // No direct programmatic API for CLI commands","symbol":"Display Revisions Command","correct":"ember deploy:list <environment> [--amount <N>]"},{"note":"Configuration options like `amount` and `revisions` (the data source) are typically set in your Ember application's `config/environment.js` file under the `ENV['display-revisions']` key.","symbol":"Configuration","correct":"ENV['display-revisions'] = { amount: 10, revisions: function(context) { return context.revisions; } };"}],"quickstart":{"code":"ember install ember-cli-deploy-display-revisions\n\n# Configure in config/environment.js (example)\n// ENV['display-revisions'] = {\n//   amount: 15, // Display up to 15 revisions\n//   revisions: function(context) {\n//     return context.revisions; // Use revisions from the deploy context\n//   }\n// };\n\n# To list the latest 10 deployed revisions for the 'production' environment\nember deploy:list production\n\n# To list the latest 5 deployed revisions for the 'staging' environment\nember deploy:list --amount 5 staging","lang":"javascript","description":"This quickstart demonstrates how to install the plugin and use its primary CLI commands to list deployed revisions, including an example of specifying the number of revisions to display."},"warnings":[{"fix":"Ensure your project's Node.js environment meets the new requirements (Node.js v14, v16, v18, or v20+). Update your Node.js version if necessary. You may also need to update `ember-cli` and `ember-cli-deploy` to compatible versions.","message":"Version 3.0.0 introduces updated dependency requirements and significantly stricter Node.js version requirements, now demanding `14.* || 16.* || 18.* || >= 20`.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Upgrade your Node.js environment to version 10 or higher. Review your `package.json` for `ember-cli` and `ember-cli-deploy` versions and update them if they are incompatible with Node 10+.","message":"Version 2.0.0 broke compatibility for older Node.js environments, requiring Node.js 10 or higher, and also included updates to `ember-cli` dependencies.","severity":"breaking","affected_versions":">=2.0.0 <3.0.0"},{"fix":"This is expected behavior. The plugin's functionality is exposed via `ember deploy:*` commands and its internal tests are run via `yarn test` in its own repository, not within your application context. Do not try to include this plugin in your Ember application's `app` or `tests` directories in a way that would trigger Ember CLI's build or test lifecycles.","message":"As a Node-only Ember CLI addon, `ember-cli-deploy-display-revisions` does not work with standard `ember build` or `ember test` commands directly within your application's test suite or build process.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Ensure that the `timestamp` field in the `context.revisions` data provided by your `fetchRevisions` plugin is either a millisecond timestamp (e.g., `1438232435000`) or a valid ISO 8601 string to be correctly parsed by Luxon.","message":"With the internal switch from Moment.js to Luxon in v2.1.0 and subsequent bug fixes in v2.1.1 and v2.1.2, users might encounter issues with timestamp parsing and display if revision data timestamps are not in the expected milliseconds-since-epoch or ISO format.","severity":"gotcha","affected_versions":">=2.1.0"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Update your Node.js environment to a compatible version (14.*, 16.*, 18.*, or >= 20).","cause":"Attempting to use the plugin with an unsupported Node.js version, especially prior to v14.","error":"Error: Node.js version X.X.X is not supported by ember-cli-deploy-display-revisions@3.0.0"},{"fix":"Ensure `ember-cli-deploy` is correctly installed in your project and configured. Verify that `ember deploy --help` works, indicating the `deploy` command is available.","cause":"`ember-cli-deploy-display-revisions` is installed, but `ember-cli-deploy` itself, or its `deploy` command, is not properly set up.","error":"ember deploy:list: command not found"},{"fix":"Verify that your `fetchRevisions` plugin provides timestamps in the `context.revisions` array as either milliseconds since epoch or a valid ISO 8601 string, as expected by Luxon. For example: `{ revision: 'abc', timestamp: 1438232435000 }` or `{ revision: 'abc', timestamp: '2015-07-30T10:00:00.000Z' }`.","cause":"The `timestamp` format provided by the `fetchRevisions` plugin is not correctly parsed by Luxon after the v2.1.0 update.","error":"The 'revisions' data does not display correctly or shows incorrect dates."}],"ecosystem":"npm","meta_description":null}