# Welcome

Awesome Cordova Plugins is a curated set of TypeScript wrappers for Cordova plugins that make adding native functionality to your [Ionic](https://ionicframework.com/) mobile app easy.

Every Cordova plugin callback is wrapped in a Promise or Observable, providing a common interface and seamless integration with Angular change detection.

## Features

* **TypeScript wrappers** for over 250 Cordova plugins
* **Promise and Observable** support for modern async patterns
* **Angular integration** with automatic change detection via `/ngx` imports
* **Framework-agnostic** — works with Angular, React, or plain TypeScript
* **Capacitor compatible** — use Cordova plugins in Capacitor projects

## Quick Start

Install the core library and any plugin wrapper you need:

```bash
npm install @awesome-cordova-plugins/core
npm install @awesome-cordova-plugins/camera
```

Then install the corresponding Cordova plugin:

```bash
ionic cordova plugin add cordova-plugin-camera
```

See the [Installation](https://danielsogl.gitbook.io/awesome-cordova-plugins/installation) guide for detailed framework-specific setup instructions.

## Need Help?

* Browse the [Plugin List](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/plugins) to find the wrapper you need
* Check the [FAQ](https://danielsogl.gitbook.io/awesome-cordova-plugins/faq) for common issues and solutions
* [Report an issue](https://github.com/danielsogl/awesome-cordova-plugins/issues) or contribute on GitHub

## Maintainer

[Daniel Sogl](https://www.linkedin.com/in/daniel-sogl)