Overview

The quickstart tutorial will walk you through the key concepts of Capgo! Concepts that will be explored include:

1. Adding an app to your Capgo account

2. Integrating Capgo with your CI/CD

3. Triggering bundle upload on Capgo by pushing commits

4. Configuring and customizing the Capgo bundle publishing

5. Setting up your app to enable live updates via Capgo

6. Deploying live updates to your app from Capgo

Simply follow the guide step-by-step, or navigate directly to the documentation for the component that interests you.

Start the Tutorial

Follow the quickstart tutorial and get up and running with Capgo in no time!

Ship updates

Ship updates to your app from the Capgo dashboard.

Automate updates

Integrate Capgo with your CI/CD and trigger bundle uploads on Capgo by pushing commits.

Trouble Shooting

Common issues and how to solve them.

Wrap Up

Wrap up the tutorial and get a quick overview of what you’ve learned.

Tip

The Over-the-Air (OTA) update feature is applicable only for modifications made to HTML, CSS, and JavaScript files.

If you make any changes to the native code, such as updates to Capacitor plugins, it is mandatory to resubmit the application to the app store for approval.

Join Discord Community

Join the Capacitor-updater Discord Server!

Maintenance

Plugin version	Capacitor compatibility	Maintained
v7.*.*	v7.*.*	✅
v6.*.*	v6.*.*	Critical bug only
v5.*.*	v5.*.*	⚠️ Deprecated
v4.*.*	v4.*.*	⚠️ Deprecated
v3.*.*	v3.*.*	⚠️ Deprecated
> 7	v4.*.*	⚠️ Deprecated, our CI got crazy and bumped too much version

Store Guideline Compliance

Android Google Play and iOS App Store have corresponding guidelines that have rules you should be aware of before integrating the Capacitor-updater solution within your application.

Google play

Third paragraph of Device and Network Abuse topic describe that updating source code by any method other than Google Play’s update mechanism is restricted. But this restriction does not apply to updating javascript bundles.

This restriction does not apply to code that runs in a virtual machine and has limited access to Android APIs (such as JavaScript in a webview or browser).

That fully allows Capacitor-updater as it updates just the JS bundles and won’t update native code.

App Store

Paragraph 3.3.2, since back in 2015’s Apple Developer Program License Agreement fully allows performing over-the-air updates of JavaScript and assets - and in its latest version (20170605) downloadable here this ruling is even broader:

Interpreted code may be downloaded to an Application but only so long as such code: (a) does not change the primary purpose of the Application by providing features or functionality that are inconsistent with the intended and advertised purpose of the Application as submitted to the App Store, (b) does not create a store or storefront for other code or applications, and (c) does not bypass signing, sandbox, or other security features of the OS.

Capacitor-updater allows you to follow these rules in full compliance so long as the update you push does not significantly deviate your product from its original App Store approved intent.

To further remain in compliance with Apple’s guidelines we suggest that App Store-distributed apps do not enable the Force update scenario, since in the App Store Review Guidelines state that:

Apps must not force users to rate the app, review the app, download other apps, or other similar actions in order to access functionality, content, or use of the app.

This is not a problem for the default behavior of background update, since it won’t force the user to apply the new version until next time they close the app, but at least you should be aware of that role if you decide to show it.

Open source

The plugin is under the LGPL-3.0 License and the back-end is AGPL-3.0 License.

💡 LGPL-3.0 means if someone modifies the code of the plugin, it’s mandatory to publish it, in open-source with the same licensing. If you use the code without modification, that doesn’t concern you. See the issue below for more details check the link 👇

Licensing?

Try GPTS Capgo to Get help instead of reading the docs

You can include it in your app without worrying

Final Notes

If you self-host and find this tool useful, please consider supporting my work by becoming a GitHub sponsor.

I made a bet to open-source all the code I built here instead of paywalling it. By opening it up instead of fighting and hiding, I believe we can make the world a better place.

To make this possible, it’s necessary for all of us to do our part, including you 🥹. If Capgo cloud doesn’t meet your needs, you can back a bootstrapped Maker here on your own terms.

Simple Maths

The price of the basic plan: $14*12 = $168 a year. While average dev/hour = $60. That means that 3 hours wasted of dev time on self-host allows you to pay for a whole year, if you spent more than 3 hours you’re losing money ^^