Sign inConnect your agent
notableaddedAtlassian calls it: Added

New forge module commands in Forge CLI version 13.0.0 (Preview)

Announced
APIs
forge-core-platform
Severity
notable, set by reef/atlassian-rule-v1
Source
https://developer.atlassian.com/changelog/#CHANGE-3316

The Forge CLI now includes a new forge module command group (in Preview) for adding modules to an existing app — and for discovering and inspecting the modules you can add — directly from the command line.

What's changing

Previously, adding a module to an existing app meant editing your manifest.yml and creating the source files yourself. The new forge module command group gives you three subcommands to do this from the command line:

  • forge module add — add a module to your app. The command guides you through choosing a module and UI framework (UI Kit or custom UI), then generates the source files, updates your manifest.yml, and installs any required dependencies. Use --dry-run to preview the changes first.
  • forge module list — browse the available module templates, filterable by product, UI framework, or module key.
  • forge module show <moduleType> — view the details and documentation for a specific module.

Why this matters

  • Faster setup: scaffold a new module in seconds instead of wiring up the manifest, files, and dependencies by hand.
  • Safer changes: forge module add runs key-collision and file-conflict checks before writing anything, and --dry-run lets you preview first.
  • Efficient resource usage: modules are bundled using multi-entry resource bundles.

Key details

  • forge module add extends an app you already have. To scaffold a brand-new app from a template, use forge create instead.
  • The manifest and resources that forge module add generates are built on multi-entry resource bundles, a Preview feature.
  • Custom UI modules are scaffolded with a Vite-based build setup.
  • These commands are in Preview and may modify your app files (manifest.yml, source files, and package.json). We recommend committing your work beforehand.
  • Only a subset of Forge modules is available today, and we're adding more over time.

The text above is Atlassian's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.