# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://danielsogl.gitbook.io/awesome-cordova-plugins/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.