CLAUDE.md git:20260616.78b437bA

Immutable. This exact content never changes and is served at /api/v1/blob/2d16ad6c8f70175d.

# 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