Commencer

Nouveau Project Installation

1. Installer core packages

   npm install @capacitor-plus/core @capacitor-plus/cli

2. Ajouter platform packages

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Initialiser Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Ajouter platforms

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

Migrating from Official Capacitor

If you have an existing Capacitor project, migrating to Capacitor+ is simple:

1. Retirer official packages

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Installer Capacitor+ packages

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. Synchroniser your project

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Note

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

Utilisation

Since Capacitor+ is API-compatible, your existing code works without changes:

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

With Official Capacitor Plugins

All official Capacitor plugins work seamlessly:

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

With Capgo Plugins

Capgo plugins work perfectly with Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

How the Synchroniser Works

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Daily Sync: GitHub Actions fetch latest changes from ionic-team/capacitor
2. PR Creation: Changes are proposed as pull requests to the plus branch
3. CI Validation: Full Test suite runs (lint, unit tests, iOS Construction, Android Construction)
4. Sécurité Review: AI-powered analysis checks for vulnerabilities and breaking changes
5. Auto-Merge: Only if CI passes AND Sécurité review approves
6. Auto-Publish: New version published to npm under @capacitor-plus/*

Sécurité Review Details

Every upstream Synchroniser is analyzed for:

Vérifier	What It Catches
Sécurité	Commande injection, XSS, path traversal, hardcoded secrets
Breaking Changes	Removed/renamed APIs, changed signatures, config 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

Attention

If any issues are detected, the PR is flagged for manual review and will NOT be auto-merged. This ensures you always get Stable, secure releases.

Submitting Your PR

Have a PR stuck in the official Capacitor repo? Get it merged in Capacitor+:

1. Open an Problème in the Capacitor+ repo linking to your upstream PR

2. Or submit directly as a PR to the plus branch

3. The team will review, run CI, and merge if it passes

This way you and others can benefit from your work immediately without waiting for the upstream Libération cycle.

FAQ

Is this Production-ready?

Yes. Capacitor+ is used in Production apps. Every Libération passes the same Test suite as official Capacitor, plus additional Sécurité analysis.

Will my official plugins still work?

Yes. All @capacitor/* plugins work with Capacitor+ out of the box.

What if upstream releases a breaking change?

The AI Sécurité review flags breaking changes for manual review. You’ll see the changes documented before they’re merged.

How do I Signaler issues?

File issues on the Capacitor+ GitHub repo. For issues that also affect official Capacitor, we’ll Aide coordinate upstream.

Can I contribute?

Absolutely! PRs are welcome. You can Soumettre fixes directly or request that specific upstream PRs be merged.