\n ⚡️ Cross-platform apps with JavaScript and the Web ⚡️\n
\n \n
\n \n \n \n \n
\n
\n \n \n
\n\n---\n\nCapacitor lets you run web apps natively on iOS, Android, Web, and more with a single codebase and cross-platform APIs.\n\nCapacitor 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.\n\nCapacitor 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.\n\n## Getting Started\n\nCapacitor was designed to drop-in to any existing modern web app. Run the following commands to initialize Capacitor in your app:\n\n```\nnpm install @capacitor/core @capacitor/cli\nnpx cap init\n```\n\nNext, install any of the desired native platforms:\n\n```\nnpm install @capacitor/android\nnpx cap add android\nnpm install @capacitor/ios\nnpx cap add ios\n```\n\n### New App?\n\nFor new apps, we recommend trying the [Ionic Framework](https://ionicframework.com/) with Capacitor.\n\nTo begin, install the [Ionic CLI](https://ionicframework.com/docs/cli/) (`npm install -g @ionic/cli`) and start a new app:\n\n```\nionic start --capacitor\n```\n\n## FAQ\n\n#### What are the differences between Capacitor and Cordova?\n\nIn spirit, Capacitor and Cordova are very similar. Capacitor offers backward compatibility with a vast majority of Cordova plugins.\n\nCapacitor and Cordova differ in that Capacitor:\n\n- takes a more modern approach to tooling and plugin development\n- treats native projects as source artifacts as opposed to build artifacts\n- is maintained by the Ionic Team 💙😊\n\nSee [the docs](https://capacitorjs.com/docs/cordova#differences-between-capacitor-and-cordova) for more details.\n\n#### Do I need to use Ionic Framework with Capacitor?\n\nNo, 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](https://ionicframework.com/docs/cli/livereload). See [the docs](https://capacitorjs.com/docs/getting-started/with-ionic) for more details.\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](./CONTRIBUTING.md).\n\n## Contributors\n\nMade possible by the [Capacitor community](https://github.com/ionic-team/capacitor/graphs/contributors). 💖\n","readmeFilename":"README.md"}
![](\"https://user-images.githubusercontent.com/236501/105104854-e5e42e80-5a67-11eb-8cb8-46fccb079062.png\")
![](\"https://img.shields.io/github/actions/workflow/status/ionic-team/capacitor/ci.yml?style=flat-square\")
![](\"https://img.shields.io/npm/dw/@capacitor/core?style=flat-square\")
![](\"https://img.shields.io/npm/v/@capacitor/core?style=flat-square\")
![](\"https://img.shields.io/npm/l/@capacitor/core?style=flat-square\")
![](\"https://img.shields.io/static/v1?label=docs&message=capacitorjs.com&color=blue&style=flat-square\")
![](\"https://img.shields.io/twitter/follow/capacitorjs\")