Capacitor Performance

This walks you through the performance bottlenecks that hit Capacitor apps hardest: bloated bundles from eager plugin imports, janky animations from non-GPU-accelerated CSS, and sluggish native bridge calls from chatty back-and-forth patterns. The quick wins section is solid, especially the lazy loading pattern and the batching advice for storage operations. It covers profiling with Chrome DevTools, Xcode Instruments, and Android Profiler, though you'll need to know your way around those tools already. The virtual scrolling and debouncing examples are framework-agnostic pseudocode, so you'll adapt them to React, Vue, or whatever you're using. Good for when your app feels slow and you need a checklist of likely culprits rather than deep performance theory.

skills.sh installs: 1.3K
GitHub stars: 77
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capgo-skills --skill capacitor-performance --agent claude-code

Installs into .claude/skills of the current project.

Files

Capacitor Performance

Find the bottleneck first (WebView JS, bridge, native, or network), then fix the specific cause. Generic web advice (code splitting, image compression, virtual lists) still applies; this skill focuses on what is different inside Capacitor.

When to Use

TRIGGER when:

Cold start is slow, splash stays long, or the first screen is blank for seconds.
App "restarts" or shows a white screen after taking a photo, opening a big file, or returning from background.
Native calls feel slow, especially with images, files, or large HTTP responses.
Scrolling/animations jank only on device (often older Android WebView).
Memory grows over time; listeners pile up.

Do not use:

Crashes, native stack traces -> debugging-capacitor, capacitor-native-observability.
Getting logs off a device -> ios-android-logs.
Offline storage design / SQLite migration -> capacitor-offline-first, sqlite-to-fast-sql.
Splash screen setup -> capacitor-splash-screen; keyboard resize jank -> capacitor-keyboard.
OTA bundle size and delta updates -> capgo-live-updates.