Skip to main content
@capgo/cordova-updater Updates Open source

Cordova Updater Cordova plugin

OTA live updates for Cordova iOS and Android with the same API as capacitor-updater

Install

bun add @capgo/cordova-updater
npm, pnpm or yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

Guide

How to use Cordova Updater in Cordova

Using @capgo/cordova-updater

@capgo/cordova-updater brings Capgo live updates to Cordova iOS and Android apps with the same JavaScript API as @capgo/capacitor-updater. Install the Cordova plugin, call notifyAppReady() on every launch, and upload bundles with @capgo/cli.

Installation

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

Basic usage

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const downloaded = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: downloaded.id });
  }
});

Platform requirements

  • Cordova Android 13+ and Cordova iOS 7+
  • Default Cordova WebView schemes (https://localhost/ on Android, app://localhost/ on iOS)
  • Avoid cordova-plugin-ionic-webview — it prevents bundle swapping

Deploy a new bundle

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

Practical advice

  • Reuse the same Capgo app ID and channels if you also ship a Capacitor or Electron client.
  • Treat native plugin or Cordova platform upgrades like any other native change: ship a new store binary before relying on new native APIs in JavaScript bundles.
  • Full setup details live in the Cordova updater docs.

FAQ

Cordova Updater plugin FAQ

How do I install the Cordova Updater plugin in a Cordova app?

Run "bun add @capgo/cordova-updater" (or "npm install @capgo/cordova-updater"), then follow the Cordova setup steps in the guide and the GitHub README.

Does @capgo/cordova-updater work with React, Vue and Angular?

Yes. Cordova Updater is a Cordova package, so it works with any web framework that runs inside Cordova, React, Vue, Angular, Svelte and plain JavaScript.

Is @capgo/cordova-updater free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/cordova-updater/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Ship Cordova Updater changes without waiting for app review

Once the plugin is in your store build, Capgo live updates push your JavaScript, HTML and CSS changes to users in minutes.

Start with Capgo