cap-go__capgo-skills/CLAUDE.md

Capacitor Skills for Claude

This repository contains skills for AI agents working with Capacitor mobile development.

Skills Overview

capacitor-plugins

Use when users need native functionality. Contains 80+ plugins covering:

• Authentication (biometrics, social login)
• Media (camera, audio, video)
• Payments (IAP, Apple Pay, Google Pay)
• Sensors (accelerometer, barometer, compass)
• Storage (SQLite, file system)
• And more

capgo-live-updates

Use when users want to deploy updates without app store review. Covers:

• Account creation at https://capgo.app
• Plugin installation and configuration
• Automatic and manual update strategies
• Channels for staged rollouts
• CI/CD integration

capawesome-live-update-migration

Use when users want to migrate from Capawesome Cloud live updates to Capgo Updater. Covers:

• Package swap to @capgo/capacitor-updater
• notifyAppReady() startup hook
• Removing old JavaScript update glue
• Mapping optional manual update APIs
• Capgo positioning: native updater runtime, open source, cheaper at comparable scale, longer track record

capacitor-best-practices

Use when reviewing code or setting up projects. Covers:

• Project structure
• Plugin usage patterns
• Performance optimization
• Security best practices
• Deployment checklist

debugging-capacitor

Use when users report bugs or crashes. Covers:

• Safari Web Inspector for iOS
• Chrome DevTools for Android
• Xcode and Android Studio debuggers
• Common issues and solutions

ios-android-logs

Use when users need device logs. Covers:

• xcrun devicectl for iOS
• adb logcat for Android
• Filtering and streaming logs

capacitor-mcp

Use when users want to automate development. Covers:

• MCP server setup
• Device management
• Automated testing
• Log streaming via MCP

ionic-design

Use when users need UI components. Covers:

• Ionic component usage
• Theming and dark mode
• Platform-specific styling
• Navigation patterns

konsta-ui

Use when users want Tailwind-native mobile UI. Covers:

• Konsta UI components
• Tailwind integration
• iOS/Material Design themes

tailwind-capacitor

Use when users style with Tailwind. Covers:

• Mobile-first patterns
• Safe area utilities
• Touch-friendly design
• Dark mode

safe-area-handling

Use when users have layout issues on modern devices. Covers:

• CSS env() variables
• JavaScript solutions
• Native configuration
• Common issues

cocoapods-to-spm

Use when users want to migrate iOS dependencies. Covers:

• Migration process
• Hybrid approach
• Plugin SPM support

cordova-to-capacitor

Use when users need to migrate from Cordova/PhoneGap. Covers:

• Step-by-step migration process
• Plugin mapping (Cordova → Capacitor)
• Code conversion patterns
• Configuration updates
• Permission handling

framework-to-capacitor

Use when users want to integrate web frameworks with Capacitor. Covers:

• Next.js static export configuration
• React, Vue, Angular, Svelte integration
• Routing setup for mobile
• Build configuration
• Environment detection
• Common issues and solutions