Skip to content

📢 channel

📢 Manage distribution channels for app updates in Capgo Cloud, controlling how updates are delivered to devices.

Add

Alias: a

Terminal window
npx @capgo/cli@latest channel add

➕ Create a new channel for app distribution in Capgo Cloud to manage update delivery.

Example:

Terminal window
npx @capgo/cli@latest channel add production com.example.app --default

Options:

ParamTypeDescription
-d,stringSet the channel as default
-a,stringAPI key to link to your account

🗑️ Delete

Alias: d

Terminal window
npx @capgo/cli@latest channel delete

🗑️ Delete a channel from Capgo Cloud, optionally removing associated bundles to free up resources.

Example:

Terminal window
npx @capgo/cli@latest channel delete production com.example.app

Options:

ParamTypeDescription
-a,stringAPI key to link to your account
—delete-bundlebooleanDelete the bundle associated with the channel
—success-if-not-foundbooleanSuccess if the channel is not found

📋 List

Alias: l

Terminal window
npx @capgo/cli@latest channel list

📋 List all channels configured for an app in Capgo Cloud to review distribution settings.

Example:

Terminal window
npx @capgo/cli@latest channel list com.example.app

Options:

ParamTypeDescription
-a,stringAPI key to link to your account

📦 CurrentBundle

Terminal window
npx @capgo/cli@latest channel currentBundle

📦 Get the current bundle linked to a specific channel in Capgo Cloud for update tracking.

Example:

Terminal window
npx @capgo/cli@latest channel currentBundle production com.example.app

Options:

ParamTypeDescription
-c,stringChannel to get the current bundle from
-a,stringAPI key to link to your account
—quietbooleanOnly print the bundle version

⚙️ Set

Alias: s

Terminal window
npx @capgo/cli@latest channel set

⚙️ Configure settings for a channel, such as linking a bundle, setting update strategies (major, minor, metadata, patch, none), or device targeting (iOS, Android, dev, emulator). One channel must be default.

Example:

Terminal window
npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

Options:

ParamTypeDescription
-a,stringAPI key to link to your account
-b,stringBundle version number of the file to set
-s,stringSet the state of the channel, default or normal
—latest-remotebooleanGet the latest bundle uploaded in capgo cloud and set it to the channel
—latestbooleanGet the latest version key in the package.json to set it to the channel
—downgradebooleanAllow to downgrade to version under native one
—no-downgradebooleanDisable downgrade to version under native one
—iosbooleanAllow sending update to iOS devices
—no-iosbooleanDisable sending update to iOS devices
—androidbooleanAllow sending update to Android devices
—no-androidbooleanDisable sending update to Android devices
—self-assignbooleanAllow device to self-assign to this channel
—no-self-assignbooleanDisable devices to self-assign to this channel
—disable-auto-updatestringDisable auto update strategy for this channel. The possible options are: major, minor, metadata, patch, none
—devbooleanAllow sending update to development devices
—no-devbooleanDisable sending update to development devices
—emulatorbooleanAllow sending update to emulator devices
—no-emulatorbooleanDisable sending update to emulator devices
—package-jsonstringA list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json)