Skip to main content
Capgo logo
Back to plugins
@capgo/capacitor-updater
Tutorial
@capgo/capacitor-updater

Updater

Deploy Ionic and Capacitor live updates instantly to your users without app store review delays

Downloads/month

562.0k

GitHub Stars

797

Guide

Tutorial on Updater

Ionic and Capacitor live updates with @capgo/capacitor-updater

@capgo/capacitor-updater is the open-source updater plugin behind Capgo live updates for Ionic and Capacitor apps. It downloads approved web bundles, applies them with native rollback protection, and keeps binary-only changes on the normal App Store and Play review path.

Use it when you need OTA updates for HTML, CSS, JavaScript, assets, and other web-layer changes after your native shell is already approved.

Install

npm install @capgo/capacitor-updater
npx cap sync

Where It Fits

For Ionic teams, live updates usually mean the same workflow: ship a new web bundle without forcing every user through a full store release. Capgo handles that workflow for Capacitor apps with channels, compatibility checks, rollout control, device logs, and rollback.

Native plugins, entitlements, Android manifest changes, iOS plist changes, and binary SDK updates still require a normal app store release. Keep those changes in your native build pipeline and use live updates for the approved web layer.

What This Plugin Exposes

  • notifyAppReady - Notify the native layer that JavaScript initialized successfully.
  • setUpdateUrl - Set the update URL for the app dynamically at runtime.
  • setStatsUrl - Set the statistics URL for the app dynamically at runtime.
  • setChannelUrl - Set the channel URL for the app dynamically at runtime.

Example Usage

notifyAppReady

Notify the native layer that JavaScript initialized successfully.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.notifyAppReady();

setUpdateUrl

Set the update URL for the app dynamically at runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setUpdateUrl({} as UpdateUrl);

setStatsUrl

Set the statistics URL for the app dynamically at runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setStatsUrl({} as StatsUrl);

setChannelUrl

Set the channel URL for the app dynamically at runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setChannelUrl({} as ChannelUrl);

Full Reference

Keep going from @capgo/capacitor-updater

If you are using @capgo/capacitor-updater to plan live updates, connect it with Live Updates for the product workflow, @capgo/capacitor-updater for implementation details, Getting Started, Channels, and Rollbacks.