Capawesome CLI 4.7.0 Release

Version 4.7.0 of the Capawesome CLI is now available. Building on the 4.5.0 release, this update brings a unified command for creating live updates, new app management commands for linking repositories and transferring apps, ad hoc environment variables for builds, and source map detection to keep your production bundles clean.

Unified Live Update Command

The new apps:liveupdates:create command builds your web bundle on a Capawesome Cloud Runner and deploys it to one or more channels — all in a single command. Unlike local bundling and uploading, the build runs in a managed cloud environment, giving you consistent and reproducible builds every time. It also consolidates the previous two-step workflow of apps:builds:create and apps:deployments:create into one:

npx @capawesome/cli apps:liveupdates:create \
  --app-id your-app-id \
  --git-ref main \
  --channel production

You can deploy to multiple channels at once by specifying --channel more than once:

npx @capawesome/cli apps:liveupdates:create \
  --app-id your-app-id \
  --git-ref main \
  --channel staging \
  --channel production

The command also supports gradual rollouts with --rollout-percentage, native version constraints, and custom properties — giving you full control over each live update deployment in a single command. In addition to --git-ref, you can use --path to upload local source files or --url to build from a remote ZIP file.

App Linking

Two new commands let you connect and disconnect git repositories to your apps directly from the CLI:

• apps:link: Connect a git repository to an app
• apps:unlink: Disconnect a git repository from an app

The apps:link command automatically detects repository information from your local git remote, so all you need to do is run:

npx @capawesome/cli apps:link \
  --app-id your-app-id

This is particularly useful when setting up new projects or configuring CI/CD pipelines — the CLI figures out the git provider, owner, and repository name for you.

App Transfer

The new apps:transfer command lets you move an app from one organization to another without having to recreate it:

npx @capawesome/cli apps:transfer \
  --app-id your-app-id \
  --organization-id target-org-id

This comes in handy when reorganizing your workspace or handing off a project to another team.

Ad Hoc Environment Variables

The apps:builds:create and apps:liveupdates:create commands now support ad hoc environment variables that are passed directly to the build without having to configure them in the Cloud Console first:

npx @capawesome/cli apps:builds:create \
  --app-id your-app-id \
  --platform android \
  --git-ref main \
  --variable "API_URL=https://api.example.com" \
  --variable "DEBUG=false"

You can also load variables from a file using --variable-file:

npx @capawesome/cli apps:builds:create \
  --app-id your-app-id \
  --platform ios \
  --git-ref main \
  --variable-file .env.production

This makes it easy to customize builds on the fly — especially in CI/CD pipelines where you want to inject environment-specific values without persisting them in the Cloud Console.

Source Map Detection

The CLI now warns you when source maps are detected in your live update bundles. Source maps can unintentionally expose your source code to end users, so catching them before deployment helps keep your production builds secure.

This check runs automatically during apps:liveupdates:bundle, apps:liveupdates:upload, and apps:liveupdates:generatemanifest — no extra configuration needed.

Other Improvements

Here are some additional changes in v4.6.0–v4.7.0:

• Batch device operations: The apps:devices:forcechannel and apps:devices:unforcechannel commands now accept multiple --device-id flags, so you can update several devices at once.
• Certificate type filtering: The apps:certificates:get and apps:certificates:delete commands now support a --type option for more targeted certificate selection.
• Bug fixes: Improved error messages for invalid private keys, fixed login token handling with extra whitespace, and better status reporting for canceled builds.

Upgrading

To upgrade to the latest version, run:

npm install -g @capawesome/cli@latest

Try Capawesome Cloud

If you haven't tried Capawesome Cloud yet, now is a great time to get started. Manage your builds, live updates, and app store submissions — all from the command line.

Try Capawesome Cloud Free

Final Thoughts

Capawesome CLI 4.7.0 makes live update workflows significantly simpler with the new unified apps:liveupdates:create command, and gives you more flexibility with ad hoc environment variables and app management features like linking and transferring. The source map detection adds an extra layer of safety to your deployment process.

For more details on previous releases, check out the Capawesome CLI 4.5.0 Release blog post. If you have any questions, feel free to join the Capawesome Discord server. And don't forget to subscribe to our newsletter to stay updated on the latest releases.