ionic-team /capacitor
Build cross-platform Native Progressive Web Apps for iOS, Android, and the Web ⚡️
★ 17,094⑂ 1,319👁 166⑃ 3,298● 3,921▤ 219
More from this author
+6
Daily
17,094
stars
1,319
forks
166
watchers
3,298
prs
3,921
issues
219
releases
README
⚡️ Cross-platform apps with JavaScript and the Web ⚡️ --- Capacitor lets you run web apps natively on iOS, Android, Web, and more with a single codebase and cross-platform APIs. Capacitor provides a cross-platform API and code execution layer that makes it easy to call Native SDKs from web code and to write custom native plugins that your app may need. Additionally, Capacitor provides first-class Progressive Web App support so you can write one app and deploy it to the app stores _and_ the mobile web. Capacitor comes with a Plugin API for building native plugins. Plugins can be written inside Capacitor apps or packaged into an npm dependency for community use. Plugin authors are encouraged to use Swift to develop plugins in iOS and Kotlin (or Java) in Android. Getting Started Capacitor was designed to drop-in to any existing modern web app. Run the following commands to initialize Capacitor in your app: npm install @capacitor/core @capacitor/cli npx cap init Next, install any of the desired native platforms: npm install @capacitor/android npx cap add android npm install @capacitor/ios npx cap add ios New App? For new apps, we recommend trying the Ionic Framework with Capacitor. To begin, install the Ionic CLI (npm install -g @ionic/cli) and start a new app: ionic start --capacitor FAQ What are the differences between Capacitor and Cordova? In spirit, Capacitor and Cordova are very similar. Capacitor offers backward compatibility with a vast majority of Cordova plugins. Capacitor and Cordova differ in that Capacitor: - takes a more modern approach to tooling and plugin development - treats native projects as source artifacts as opposed to build artifacts - is maintained by the Ionic Team 💙😊 See the docs for more details. Do I need to use Ionic Framework with Capacitor? No, you do not need to use Ionic Framework with Capacitor. Without the Ionic Framework, you may need to implement Native UI yourself. Without the Ionic CLI, you may need to configure tooling yourself to enable features such as livereload. See the docs for more details. Contributing See CONTRIBUTING.md. Contributors Made possible by the Capacitor community. 💖
Top issues
#3589bug: iOS 14 Black screen always on initial app launch prior to actually showing the splash screen [SplashScreen]81 comments · 2020-09-22#3210feat: send Referer header on ios15 comments · 2020-07-06#8054[Bug]: iOS margins broken after iframe goes fullscreen15 comments · 2025-07-09#6177Consolidated issue cataloguing all Fetch/HTTP issues with test harness12 comments · 2022-12-19#5478bug: Blob downloads don't work on iOS & Android12 comments · 2022-03-02#8231[Bug]: iOS App WebView viewport shrinks after exiting fullscreen mode9 comments · 2025-11-12#8076[Bug]: iOS not sending url encoded data if it's a number 9 comments · 2025-07-21#7974[Bug]: Xcode 16.3 simulator bug causes network access to fail?9 comments · 2025-04-14
Discussions
#8712Have `cap doctor` warn when an iOS project has not adopted UIScene0 comments · 2026-11-13#8711capacitor-ios26-check: audit a Capacitor 8 iOS project for the iOS 26 launch crash0 comments · 2026-11-13#8696Capacitor 7 Plugins don't compile in Xcode 27.2 (They did in 27.1)1 comments · 2026-11-05#8650Using Capacitor.js with TanStack start & route0 comments · 2026-10-11#8627Migrating a Next.js (App Router + Server Components/Actions) app from Capacitor server.url to an embedded, offline-first build (Android + iOS). Who has done it?4 comments · 2026-09-25#8626NOTICE attribution for Cordova.xcframework.zip in Capacitor SPM 8.5.03 comments · 2026-09-24#8610Will Capacitor 9 support the new ACCESS_LOCAL_NETWORK permission in Android 17 (SDK 37)?2 comments · 2026-09-18#8598Svelte custom renderer1 comments · 2026-09-10
Latest release
8.6.2 8.6.2 2026-11-128.6.2 (2026-11-12) Note: Version bump only for package capacitor