--- description: Capawesome CLI 4.0.0 brings new live update commands, channel management features, web build support, and important breaking changes. title: Capawesome CLI 4.0.0 Release - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/capawesome-cli-4-0-0-release.png --- [ Skip to content](#capawesome-cli-400-release) [ πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode.](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm or Yarn ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ New Features ](#new-features) * [ Upgrading ](#upgrading) * [ Migration Guide ](#migration-guide) * [ Feedback ](#feedback) # Capawesome CLI 4.0.0 Release[ΒΆ](#capawesome-cli-400-release "Permanent link") We are excited to announce version 4.0.0 of the [Capawesome CLI](/docs/cloud/cli/)! This major release brings a host of new features and improvements to enhance your development experience, including new commands for managing live updates, channel control, and web build support. This release also includes some breaking changes that you should be aware of before upgrading. ## Breaking Changes[ΒΆ](#breaking-changes "Permanent link") Before upgrading, please review the following breaking changes: ### Minimum Node.js Version[ΒΆ](#minimum-nodejs-version "Permanent link") The minimum required Node.js version has been updated to **Node.js 20**. This ensures better performance, security, and access to the latest JavaScript features. Please update your Node.js installation before upgrading to CLI 4.0.0. ### Renamed Commands[ΒΆ](#renamed-commands "Permanent link") Several commands have been renamed to better reflect their purpose and align with the new build and deployment system: | Old Command | New Command | | ------------------- | ---------------------------------------------------- | | apps:bundles:create | apps:liveupdates:upload or apps:liveupdates:register | | manifests:generate | apps:liveupdates:generatemanifest | The `apps:bundles:create` command has been split into two separate commands: * [apps:liveupdates:upload](/docs/cloud/cli/commands/#appsliveupdatesupload): Upload a locally built bundle and deploy it to a channel * [apps:liveupdates:register](/docs/cloud/cli/commands/#appsliveupdatesregister): Register a self-hosted bundle URL and deploy it to a channel This separation provides clearer intent and better flexibility for different deployment workflows. ## New Features[ΒΆ](#new-features "Permanent link") ### Live Update Rollback[ΒΆ](#live-update-rollback "Permanent link") The new [apps:liveupdates:rollback](/docs/cloud/cli/commands/#appsliveupdatesrollback) command allows you to quickly roll back the active build in a channel to a previous deployment: `[](#%5F%5Fcodelineno-0-1)npx @capawesome/cli apps:liveupdates:rollback \ [](#%5F%5Fcodelineno-0-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-0-3) --channel production \ [](#%5F%5Fcodelineno-0-4) --steps 1 ` The `--steps` option specifies how many deployments to go back (1-5), making it easy to revert to a known working state when issues arise. See our [Rollbacks](/docs/cloud/live-updates/rollbacks/) guide for more details. ### Live Update Rollout[ΒΆ](#live-update-rollout "Permanent link") Control the rollout percentage of your live updates with the new [apps:liveupdates:rollout](/docs/cloud/cli/commands/#appsliveupdatesrollout) command: `[](#%5F%5Fcodelineno-1-1)npx @capawesome/cli apps:liveupdates:rollout \ [](#%5F%5Fcodelineno-1-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-1-3) --channel production \ [](#%5F%5Fcodelineno-1-4) --percentage 25 ` This enables gradual rollouts, allowing you to deploy updates to a subset of users before rolling out to everyone. For more information on implementing gradual rollouts, see our [Rollouts](/docs/cloud/live-updates/rollouts/) guide. ### Channel Pausing and Resuming[ΒΆ](#channel-pausing-and-resuming "Permanent link") Two new commands give you more control over your deployment channels: * [apps:channels:pause](/docs/cloud/cli/commands/#appschannelspause): Temporarily pause a channel to stop delivering updates * [apps:channels:resume](/docs/cloud/cli/commands/#appschannelsresume): Resume a paused channel to continue delivering updates `[](#%5F%5Fcodelineno-2-1)# Pause a channel to investigate issues [](#%5F%5Fcodelineno-2-2)npx @capawesome/cli apps:channels:pause \ [](#%5F%5Fcodelineno-2-3) --app-id your-app-id \ [](#%5F%5Fcodelineno-2-4) --channel production [](#%5F%5Fcodelineno-2-5) [](#%5F%5Fcodelineno-2-6)# Resume a paused channel after resolving issues [](#%5F%5Fcodelineno-2-7)npx @capawesome/cli apps:channels:resume \ [](#%5F%5Fcodelineno-2-8) --app-id your-app-id \ [](#%5F%5Fcodelineno-2-9) --channel production ` Pausing channels is useful during maintenance windows or when you need to temporarily halt updates without removing the channel entirely. ### Protected Channels[ΒΆ](#protected-channels "Permanent link") The [apps:channels:create](/docs/cloud/cli/commands/#appschannelscreate) and [apps:channels:update](/docs/cloud/cli/commands/#appschannelsupdate) commands now support an optional `--protected` flag: `[](#%5F%5Fcodelineno-3-1)npx @capawesome/cli apps:channels:create \ [](#%5F%5Fcodelineno-3-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-3-3) --name production \ [](#%5F%5Fcodelineno-3-4) --protected ` [Protected channels](/docs/cloud/live-updates/channels/#protected-channels) provide an additional layer of security by preventing accidental modifications or deletions. ### Web Build Support[ΒΆ](#web-build-support "Permanent link") The [apps:builds:create](/docs/cloud/cli/commands/#appsbuildscreate) command now supports web builds with the `--platform web` option: `[](#%5F%5Fcodelineno-4-1)npx @capawesome/cli apps:builds:create \ [](#%5F%5Fcodelineno-4-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-4-3) --platform web \ [](#%5F%5Fcodelineno-4-4) --git-ref main ` This allows you to create web builds directly from the CLI, which can then be deployed as live updates. For more information, see our blog post on [Capawesome Cloud Web Builds](/blog/announcing-capawesome-cloud-web-builds/). ### Skip Confirmation Prompts[ΒΆ](#skip-confirmation-prompts "Permanent link") A new `--yes` (or `-y`) flag has been added to commands that require confirmation prompts: `[](#%5F%5Fcodelineno-5-1)npx @capawesome/cli apps:delete --app-id your-app-id --yes ` This is particularly useful for CI/CD pipelines and automated scripts where interactive prompts are not possible. ## Upgrading[ΒΆ](#upgrading "Permanent link") To upgrade to version 4.0.0, run: `[](#%5F%5Fcodelineno-6-1)npm install -g @capawesome/cli@latest ` Make sure you have Node.js 20 or later installed before upgrading. ## Migration Guide[ΒΆ](#migration-guide "Permanent link") If you're upgrading from a previous version, here's what you need to update: 1. **Update Node.js**: Ensure you're running Node.js 20 or later 2. **Update command names**: Replace `apps:bundles:create` with `apps:liveupdates:upload` or `apps:liveupdates:register` 3. **Update manifest command**: Replace `manifests:generate` with `apps:liveupdates:generatemanifest` ## Feedback[ΒΆ](#feedback "Permanent link") We hope these new features and improvements make your development workflow even more efficient. If you have any questions or feedback, please [create a discussion](https://github.com/capawesome-team/cli/discussions/new/choose) in our GitHub repository. Feel free to [subscribe to our newsletter](/newsletter/) to stay updated on the latest releases and features! June 8, 2026 Back to top