capacitor-plugin-upgrades

Upgrades Capacitor plugins across major versions 4 through 8 with migration guides.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-plugin-upgrades-involvex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capacitor-plugin-upgrades
Source: https://github.com/involvex/ionic-everywhere/tree/main/.agents/skills/capacitor-plugin-upgrades
Command: npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-plugin-upgrades-involvex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading a Capacitor plugin to a newer major version involves many coordinated changes across Android SDK targets, Gradle configuration, Java/Kotlin versions, and iOS deployment targets, and missing a step causes build failures. ## Core Features & Use Cases - Sequential Multi-Version Upgrades: Applies upgrade guides in order for jumps like 5→8, never skipping intermediate versions. - Automated Migration with Manual Fallback: Runs official @capacitor/plugin-migration tools first, then falls back to detailed manual steps per version. - Platform Configuration Updates: Covers Android SDK targets, Gradle plugin/wrapper versions, Kotlin 2.x migration, iOS deployment targets, and SPM/CocoaPods updates. - Use Case: You maintain a Capacitor 5 plugin and need it compatible with Capacitor 8. The skill walks through each version jump, updating build.gradle, Package.swift, and podspec files, then verifies with npm install and npx cap sync. ## Quick Start Upgrade my Capacitor plugin from version 6 to version 8 and verify the build on both platforms.

Frequently Asked Questions about capacitor-plugin-upgrades

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade a Capacitor plugin to version 8?▼

Run the official migration tool npx @capacitor/plugin-migration-v7-to-v8@latest from the plugin root, then update Android SDK targets to 36, Gradle plugin to 8.13.0, Kotlin to 2.2.20, and the iOS deployment target to 15.0. Verify with npm install and npx cap sync.

How to upgrade a Capacitor plugin across multiple major versions?▼

Apply each upgrade guide sequentially without skipping intermediate versions. For example, upgrading from 5 to 8 means applying the 5→6, 6→7, and 7→8 guides in order, running npm install and npx cap sync and verifying the build after each step.

What Node.js version is required for Capacitor 8?▼

Capacitor 8 requires Node.js 22 or higher. Earlier targets need less: Capacitor 5 requires Node 16+, Capacitor 6 requires Node 18+, and Capacitor 7 requires Node 20+.

Why does my Android build fail after a Capacitor upgrade?▼

Common causes include outdated Gradle plugin or wrapper versions, incorrect SDK targets, or old Gradle property syntax without the = sign in Capacitor 8. Run the AGP Upgrade Assistant in Android Studio and check all .gradle files for space-assignment syntax.

Can this skill upgrade a Capacitor app project?▼

No, this skill only applies to Capacitor plugin projects, not app projects. For upgrading an app project, use the capacitor-app-upgrades skill instead, which handles app-specific configuration.

What breaks when migrating Kotlin to 2.2 in Capacitor 8?▼

The kotlinOptions block is deprecated and must be replaced with a top-level kotlin compilerOptions block using JvmTarget. The kotlin-android-extensions plugin is removed, requiring kotlin-parcelize or view bindings as replacements.