Capacitor+ is an automated fork of Capacitor maintained by Capgo. It stays in sync with the official Capacitor repository through a fully automated pipeline.
Capacitor+ exists to solve a fundamental problem: great PRs sitting unmerged in the official Capacitor repository.
The Ionic team maintains Capacitor with their own priorities and release schedule. This means community contributions - bug fixes, improvements, and features - can wait months or even years to be merged. Some never make it at all.
Capacitor+ takes a different approach:
- Merge PRs from Forks - We actively merge valuable PRs that are stuck in the upstream queue. If you have a fix that's been waiting, we can include it here.
- Continuous Sync - Every change from upstream Capacitor is automatically pulled, tested, and verified
- Rapid Releases - When changes pass CI, they're automatically published to npm under the
@capacitor-plusscope - Community-First - Your contributions matter. We prioritize merging community improvements.
- Transparency - All automation is open source and visible in this repository
Have a PR stuck in the Capacitor repo? Here's how to get it into Capacitor+:
- Open an issue in this repo linking to your upstream PR
- Or submit the PR directly to the
plusbranch - We'll review it, run CI, and merge it if it passes
This way, you and others can benefit from your work immediately, without waiting for the upstream release cycle.
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ ionic-team/ │ │ CI/CD │ │ Claude Code │ │ npm publish │
│ capacitor │────▶│ Pipeline │────▶│ Security Review │────▶│ @capacitor-plus│
│ (upstream) │ │ (daily sync) │ │ (AI analysis) │ │ packages │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- Daily Sync: A GitHub Action fetches the latest changes from
ionic-team/capacitor - PR Creation: Changes are proposed as pull requests to the
plusbranch - CI Validation: Full test suite runs (lint, unit tests, iOS build, Android build)
- Claude Code Review: AI-powered comprehensive security analysis checks for:
- Security vulnerabilities (injection, XSS, etc.)
- Breaking API changes
- Crash risks and stability issues
- Data integrity and privacy concerns
- Malicious code patterns
- Auto-Merge: Only if CI passes AND Claude approves (no issues detected)
- Auto-Publish: A new version is published to npm under
@capacitor-plus/*
| Package | npm |
|---|---|
@capacitor-plus/core |
|
@capacitor-plus/cli |
 |
@capacitor-plus/android |
 |
@capacitor-plus/ios |
 |
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # for Android
npm install @capacitor-plus/ios # for iOS- Get Stuck PRs Now: Community fixes and features that are waiting in upstream? We merge them.
- Stay Current: Get upstream fixes as soon as they pass CI
- Security First: Every change is reviewed by Claude Code for vulnerabilities, breaking changes, and stability risks
- Verified Releases: Only changes that pass both CI tests AND AI security review are published
- Drop-in Replacement: Same API as Capacitor, just a different package scope
- Your Voice Matters: Submit your own PRs or request specific upstream PRs to be merged
Every upstream sync is analyzed by Claude Code for:
| Check | Description |
|---|---|
| Security | Command injection, XSS, path traversal, hardcoded secrets, etc. |
| Breaking Changes | Removed/renamed APIs, changed signatures, config format changes |
| Stability | Null dereferences, unhandled exceptions, race conditions, memory leaks |
| Data Safety | Data loss scenarios, privacy violations, insecure storage |
| Code Integrity | Obfuscated code, suspicious network calls, backdoors |
If any issues are detected, the PR is flagged for manual review and will NOT be auto-merged.
Capacitor lets you run web apps natively on iOS, Android, Web, and more with a single codebase and cross-platform APIs.
Capacitor provides a cross-platform API and code execution layer that makes it easy to call Native SDKs from web code and to write custom native plugins that your app may need. Additionally, Capacitor provides first-class Progressive Web App support so you can write one app and deploy it to the app stores and the mobile web.
Capacitor comes with a Plugin API for building native plugins. Plugins can be written inside Capacitor apps or packaged into an npm dependency for community use. Plugin authors are encouraged to use Swift to develop plugins in iOS and Kotlin (or Java) in Android.
Capacitor was designed to drop-in to any existing modern web app. Run the following commands to initialize Capacitor in your app:
npm install @capacitor/core @capacitor/cli
npx cap init
Next, install any of the desired native platforms:
npm install @capacitor/android
npx cap add android
npm install @capacitor/ios
npx cap add ios
For new apps, we recommend trying the Ionic Framework with Capacitor.
To begin, install the Ionic CLI (npm install -g @ionic/cli) and start a new app:
ionic start --capacitor
In spirit, Capacitor and Cordova are very similar. Capacitor offers backward compatibility with a vast majority of Cordova plugins.
Capacitor and Cordova differ in that Capacitor:
- takes a more modern approach to tooling and plugin development
- treats native projects as source artifacts as opposed to build artifacts
- is maintained by the Ionic Team 💙😊
See the docs for more details.
No, you do not need to use Ionic Framework with Capacitor. Without the Ionic Framework, you may need to implement Native UI yourself. Without the Ionic CLI, you may need to configure tooling yourself to enable features such as livereload. See the docs for more details.
See CONTRIBUTING.md.
Made possible by the Capacitor community. 💖
