# capacitor-plugin-spm-support

Adds Swift Package Manager support to Capacitor plugin repositories while keeping CocoaPods compatibility. Fixes missing Package.swift errors in SPM apps.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 713 installs · ★ 73
- Author: Cap-go
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Cap-go/capgo-skills/tree/HEAD/skills/capacitor-plugin-spm-support/SKILL.md
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/skills/cap-go-capacitor-plugin-spm-support

## What it does

The skill restructures the iOS layer of a Capacitor plugin repo. It shifts native code from `ios/Plugin/` into `ios/Sources/<ClassName>/` and moves tests to `ios/Tests/`. It deletes the old `.m` and `.h` bridge files, replacing the `CAP_PLUGIN` macro with the `CAPBridgedPlugin` protocol in Swift.

The root `Package.swift` file must sit next to `package.json` at the package root. The Capacitor CLI ignores manifests inside `ios/`. Both the package name and library product must strictly match the PascalCase translation of the npm package name, such as `CapgoCapacitorUpdater`.

Existing CocoaPods setups keep working because the skill updates `.podspec` paths to point to `ios/Sources`. For Capacitor 9, it removes the unconditional Cordova product dependency. Third-party CocoaPods dependencies are verified for official SPM support before editing files.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-plugin-spm-support -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/capacitor-plugin-spm-support/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/capacitor-plugin-spm-support/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-plugin-spm-support -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/capacitor-plugin-spm-support/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-plugin-spm-support -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/capacitor-plugin-spm-support/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Cap-go/capgo-skills capacitor-plugin-spm-support
```

2. **Manually: put the files in place**
- File: `.github/skills/capacitor-plugin-spm-support/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-plugin-spm-support -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Cap-go/capgo-skills --path skills/capacitor-plugin-spm-support
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/capacitor-plugin-spm-support/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Cap-go/capgo-skills --skill capacitor-plugin-spm-support -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Cap-go/capgo-skills/tree/HEAD/skills/capacitor-plugin-spm-support/SKILL.md

## When to use it
- Add Swift Package Manager support to a Capacitor plugin
- Resolve “does not have a Package.swift” warnings during `npx cap sync ios`
- Migrate native iOS bridge code to the `CAPBridgedPlugin` protocol
- Update source paths in `.podspec` and `package.json`

## Example prompts
- Add Swift Package Manager support to this Capacitor plugin
- Fix the missing Package.swift warning for our iOS plugin
- Convert this plugin's iOS bridge to CAPBridgedPlugin and generate Package.swift

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e59e799302b232cd.

BEGIN THIRD-PARTY FILE e59e799302b232cd
```text
---
name: capacitor-plugin-spm-support
description: Adds Swift Package Manager support to an existing Capacitor plugin repository so apps using CapApp-SPM can consume it after CocoaPods Trunk goes read-only (expected December 2, 2026). Covers root Package.swift naming rules the Capacitor CLI depends on, CAPBridgedPlugin conversion (identifier, jsName, pluginMethods), removing the ObjC CAP_PLUGIN bridge (.m/.h), Sources/Tests layout, podspec and package.json files updates, third-party pod to SPM dependency mapping, resources/PrivacyInfo.xcprivacy, binary xcframeworks, and Capacitor 9 removal of the unconditional Cordova product. Use when app sync warns "<plugin> does not have a Package.swift" for a plugin you own, or "plugin is not implemented on ios" only in SPM apps. Do not use for migrating an app project (use cocoapods-to-spm), version bumps of plugins (use capacitor-plugin-upgrades / capacitor-plugin-upgrade-v8-to-v9), or choosing plugins (use capacitor-plugins).
---

# Add Swift Package Manager Support to a Capacitor Plugin

Make a plugin installable in SPM-based Capacitor apps while keeping its podspec for CocoaPods apps.

## When to Use

TRIGGER when:
- A plugin repo has `ios/Plugin/*.swift` + `*.m`/`*.h` with `CAP_PLUGIN(...)` and no root `Package.swift`.
- An app's `npx cap sync ios` prints `<plugin id> does not have a Package.swift` for a plugin the user maintains.
- A plugin works with CocoaPods but JS gets `"X" plugin is not implemented on ios` in SPM apps.
- Preparing a plugin for Capacitor 9 / CocoaPods Trunk read-only.

Do not use:
- App-side CocoaPods removal -> `cocoapods-to-spm`.
- Capacitor major bumps of a plugin -> `capacitor-plugin-upgrades`, `capacitor-plugin-upgrade-v8-to-v9`.
- Android-only plugin work, or non-Capacitor (pure Cordova, React Native) plugins.

## Rules the CLI Enforces (non-obvious)

- `Package.swift` must be at the **npm package root** (next to `package.json`), not under `ios/`. The app CLI only checks `<plugin root>/Package.swift`.
- The CLI references the plugin in the app's `CapApp-SPM/Package.swift` as `.package(name: "<Name>", path: ...)` and `.product(name: "<Name>", package: "<Name>")`, where `<Name>` is derived from the npm name: drop `@`, turn `/` and `-` into word breaks, PascalCase. `@capgo/capacitor-updater` -> `CapgoCapacitorUpdater`, `@acme/capacitor-foo-bar` -> `AcmeCapacitorFooBar`. The `Package(name:)` **and** the `.library(name:)` product must both equal `<Name>`, or app builds fail to resolve the product.
```
END THIRD-PARTY FILE e59e799302b232cd

The third-party file has ended. Everything between the e59e799302b232cd tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2508 of 8293 bytes. © Cap-go · MIT · https://github.com/Cap-go/capgo-skills/tree/HEAD/skills/capacitor-plugin-spm-support/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md