capgo-live-updates

Complete guide to implementing live updates in Capacitor apps using Capgo. Covers account creation, plugin installation, configuration, update strategies, and CI/CD integration. Use this skill when users want to deploy updates without app store review.

By cap-go · 730 installs

npx skills add cap-go/capgo-skills --skill capgo-live-updates

Source repository · Upstream listing

Capgo Live Updates for Capacitor Deploy updates to your Capacitor app instantly without waiting for app store review. When to Use This Skill User wants live/OTA updates User asks about Capgo User wants to skip app store review User needs to push hotfixes quickly User wants A/B testing or staged rollouts What is Capgo? Capgo is a live update service for Capacitor apps that lets you: Push JavaScript/HTML/CSS updates instantly Skip app store review for web layer changes Roll back bad updates automatically A/B test features with channels Monitor update analytics Note : Native code changes (Swift/Kotlin/Java) still require app store submission. Getting Started Step 1: Create a Capgo Account 1. Go to https://capgo.app 2. Click "Sign Up" or "Get Started" 3. Sign up with GitHub, Google, or email 4. Choose a plan: Free : 1 app, 500 updates/month Solo : $14/mo, unlimited updates Team : $49/mo, team features Enterprise : Custom pricing Step 2: Install the CLI Step 3: Login to Capgo Or use API key: Step 4: Initialize Your App This will: Create app in Capgo dashboard Add @capgo/capacitor updater to your project Configure capacitor.config.ts Set up your first channel Step 5: Install the Plugin If not installed automatically: Configuration Basic Configuration Advanced Configuration Implementing Updates Automatic Updates (Recommended) With autoUpdate: true , updates are automatic: Important : Always call notifyAppReady() . If not called within 10 seconds, Capgo assumes the update failed and rolls back. Manual Updates For more control: Update with User Prompt Listen for Update Events Deploying Updates Deploy via CLI Deploy via CI/CD GitHub Actions GitLab CI Channels and Staged Rollouts Create Channels Deploy to Channels Staged Rollout In Capgo dashboard: 1. Go to Channels production 2. Set rollout percentage (e.g., 10%) 3. Monitor analytics 4. Increase to 50%, then 100% Device Specific Channels Rollback and Version Management Automatic Rollback If notifyAppReady() isn't called within 10 seconds, Capgo automatically rolls back to the previous working version. Manual Rollback In App Rollback Self Hosted Option For enterprise or privacy requirements: Configure app to use self hosted: Security Encrypted Updates For sensitive apps, enable encryption: Configure in app: Code Signing Verify updates are from trusted source: Monitoring and Analytics Dashboard Metrics In Capgo dashboard, view: Active devices Update success rate Rollback rate Version distribution Error logs Custom Analytics Troubleshooting Issue: Updates Not Applying 1. Check notifyAppReady() is called 2. Verify app ID matches Capgo dashboard 3. Check channel assignment 4. Review Capgo dashboard logs Issue: Rollback Loop 1. App crashes before notifyAppReady() 2. Fix: Ensure notifyAppReady() is called early 3. Temporarily disable updates to debug Issue: Slow Downloads 1. Enable delta updates (automatic) 2. Optimize bundle size 3. Use CDN (enterprise) Best Practices 1. Always call notifyAppReady() First thing after app initializes 2. Test updates on beta channel first Never push untested to production 3. Use semantic versioning Makes rollback easier 4. Monitor rollback rate High rate indicates quality issues 5. Implement error boundary Catch crashes before rollback 6. Keep native code stable Native changes need app store Resources Capgo Documentation: https://capgo.app/docs Capgo Dashboard: https://web.capgo.app Plugin GitHub: https://github.com/Cap go/capacitor updater Discord Community: https://discord.gg/capgo