5.43.0

Co-authored-by: Renovate Bot <bot@renovateapp.com>

.editorconfig

@@ -1,14 +1,15 @@
-# http://editorconfig.org
-root = true
-
-[*]
-charset = utf-8
-indent_style = space
-indent_size = 2
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[*.md]
-insert_final_newline = false
+# http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+insert_final_newline = false
 trim_trailing_whitespace = false

.eslintignore

@@ -0,0 +1,4 @@
+scripts/
+docs/
+dist/
+node_modules/

.eslintrc

@@ -0,0 +1,13 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint", "jsdoc"],
+  "extends": ["plugin:@typescript-eslint/recommended", "prettier", "plugin:jsdoc/recommended"],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["off"],
+    "@typescript-eslint/no-explicit-any": ["warn"],
+    "@typescript-eslint/no-empty-function": ["off"],
+    "@typescript-eslint/ban-types": ["warn"],
+    "@typescript-eslint/no-empty-interface": ["warn"],
+    "@typescript-eslint/no-namespace": ["off"]
+  }
+}

.gitbook.yaml

@@ -0,0 +1 @@
+root: ./docs/plugins/

.github/CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# Contributing to Ionic Native
+
+## Have an issue?
+#### There are no rules, but here are a few things to consider:
+###### Before you submit an issue:
+* Do a quick search to see if there are similar issues
+* Make sure that you are waiting for `deviceready` to fire before interacting with any plugin. If you are using Ionic, this can be done using [the `Platform.ready()` function](http://ionicframework.com/docs/api/platform/Platform/#ready).
+* **Check that you are using the latest version of** `ionic-native`, you can install the latest version by running `npm i --save @ionic-native/core@latest`
+
+###### Still having problems? submit an issue with the following details:
+* Short description of the issue
+* Steps to reproduce
+* Stack trace (if available)
+
+
+## Feature request?
+Have a plugin you'd like to see supported? Since Ionic Native is a thin wrapper around existing Cordova plugins, adding support for new plugins is as easy as creating a new wrapper for whatever plugin you'd like to add.
+
+Take a look at our [Developer Guide](https://github.com/ionic-team/ionic-native/blob/master/DEVELOPER.md) for more info on adding new plugins.

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,28 @@
+**I'm submitting a ...**  (check one with "x")
+[ ] bug report
+[ ] feature request
+[ ] support request => Please do not submit support requests here, use one of these channels: https://forum.ionicframework.com/ or https://ionicworldwide.herokuapp.com/
+
+**Current behavior:**
+<!-- Describe how the bug manifests. -->
+
+**Expected behavior:**
+<!-- Describe what the behavior would be without the bug. -->
+
+**Steps to reproduce:**
+<!-- If you are able to illustrate the bug or feature request with an example, please provide steps to reproduce. -->
+
+**Related code:**
+
+```
+insert any relevant code here
+```
+
+**Other information:**
+<!-- List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to fix, Stack Overflow links, forum links, etc. -->
+
+**Ionic info:** (run `ionic info` from a terminal/cmd prompt and paste output below):
+
+```
+insert the output from ionic info here
+```

.github/workflows/nodejs.yml

@@ -0,0 +1,33 @@
+name: Node CI
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [14.x]
+
+    steps:
+      - uses: actions/checkout@v3.0.2
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3.2.0
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint -- --quiet
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm run test
+
+      - name: Readmes
+        run: npm run readmes

.github/workflows/npmpublish.yml

@@ -0,0 +1,35 @@
+name: Release Packages
+
+on:
+  workflow_dispatch:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3.0.2
+      - uses: actions/setup-node@v3.2.0
+        with:
+          node-version: 14
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Readmes
+        run: npm run readmes
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3.0.2
+      - uses: actions/setup-node@v3.2.0
+        with:
+          node-version: 14
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci
+      - run: npm run shipit
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

.github/workflows/stale.yml

@@ -0,0 +1,22 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '0 0 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v5
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'There has been no recent activity and this issue has been marked inactive.'
+        stale-pr-message: 'There has been no recent activity and this PR has been marked inactive.'
+        stale-issue-label: 'status: inactive'
+        stale-pr-label: 'status: inactive'

.gitignore

@@ -1,3 +1,13 @@
+.DS_Store
 node_modules/
 .idea
+.tmp
+aot/
+scripts/ionic-native-bower
+scripts/docs-json/*.json
+scripts/docs-json/typedoc-docs
 dist/
+src/@awesome-cordova-plugins/plugins/**/ngx
+*.d.ts
+injectable-classes.json
+

.husky/.gitignore

@@ -0,0 +1 @@
+_

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no-install lint-staged

.husky/pre-push

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npm test

.prettierignore

@@ -0,0 +1,10 @@
+package.json
+node_modules
+.github
+.vscode
+dist
+CHANGELOG.md
+.husky
+.prettierignore
+LICENSE
+docs/

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib"
+}

CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of the Ionic project, we pledge to respect everyone who contributes by posting issues, updating documentation, submitting pull requests, providing feedback in comments, and any other activities.
+
+Communication through any of Ionic's channels (GitHub, Slack, Forum, IRC, mailing lists, Twitter, etc.) must be constructive and never resort to personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+We promise to extend courtesy and respect to everyone involved in this project regardless of gender, gender identity, sexual orientation, disability, age, race, ethnicity, religion, or level of experience. We expect anyone contributing to the Ionic project to do the same.
+
+If any member of the community violates this code of conduct, the maintainers of the Ionic project may take action, removing issues, comments, and PRs or blocking accounts as deemed appropriate.
+
+If you are subject to or witness unacceptable behavior, or have any other concerns, please email us at [hi@ionicframework.com](mailto:hi@ionicframework.com).

CONTRIBUTING.md

@@ -1,5 +0,0 @@
-# Contributing to Ionic Native
-
-Have a plugin you'd like to see supported? Because Ionic Native is a thin wrapper around existing Cordova plugins, adding support for new plugins is as easy as creating a new wrapper for whichever plugin you'd like to add.
-
-Take a look at our [Developer Guide](https://github.com/driftyco/ionic-native/blob/master/DEVELOPER.md) for more info on adding new plugins.

DEVELOPER.md

@@ -2,9 +2,22 @@
 
 This is a short guide on creating new plugin wrappers for Ionic Native.
 
-
 ## Creating Plugin Wrappers
 
+First, let's start by creating a new plugin wrapper from template.
+
+```
+// Call this command, and replace PluginName with the name of the plugin you wish to add
+// Make sure to capitalize the first letter, or use CamelCase if necessary.
+
+gulp plugin:create -n PluginName
+
+// add -m flag to get a minimal template to start with
+gulp plugin:create -m -n PluginName
+```
+
+Running the command above will create a new directory `src/@ionic-native/plugins/plugin-name/` with a single file in there: `index.ts`. This file is where all the plugin definitions should be.
+
 Let's take a look at the existing plugin wrapper for Geolocation to see what goes into an Ionic Native plugin (comments have been removed for clarity):
 
 ```
@@ -12,17 +25,18 @@ Let's take a look at the existing plugin wrapper for Geolocation to see what goe
   plugin: 'cordova-plugin-geolocation',
   pluginRef: 'navigator.geolocation'
 })
+@Injectable()
 export class Geolocation {
 
   @Cordova()
-  static getCurrentPosition(options?: GeolocationOptions): Promise<Geoposition> { return }
+  getCurrentPosition(options?: GeolocationOptions): Promise<Geoposition> { return; }
 
   @Cordova({
     callbackOrder: 'reverse',
     observable: true,
     clearFunction: 'clearWatch'
   })
-  static watchPosition(options?: GeolocationOptions): Observable<Geoposition> { return }
+  watchPosition(options?: GeolocationOptions): Observable<Geoposition> { return; }
 }
 ```
 
@@ -31,6 +45,7 @@ export class Geolocation {
 First and foremost, we want to create a class representing our plugin, in this case Geolocation.
 
 ```
+@Injectable()
 class Geolocation {
 
 }
@@ -47,6 +62,7 @@ For example, the `@Plugin` decorator adds information about the plugin to our Ge
   plugin: 'cordova-plugin-geolocation',
   pluginRef: 'navigator.geolocation'
 })
+@Injectable()
 export class Geolocation {
 
 }
@@ -54,7 +70,7 @@ export class Geolocation {
 
 Here, `plugin` is the name of the plugin package on npm and used when calling `cordova plugin add`.
 
-`pluginRef` refers to the where on `window` the underlying Cordova plugin is normally exposed.  For example, in the case of the Cordova Geolocation plugin, normally you would make calls like `window.navigator.geolocation.getCurrentPosition({}, success, error)`, so the `pluginRef` in this case is `navigator.geolocation`.
+`pluginRef` refers to the where on `window` the underlying Cordova plugin is normally exposed. For example, in the case of the Cordova Geolocation plugin, normally you would make calls like `window.navigator.geolocation.getCurrentPosition({}, success, error)`, so the `pluginRef` in this case is `navigator.geolocation`.
 
 #### Class Methods
 
@@ -64,14 +80,12 @@ Let's take a look at `getCurrentPosition` first.
 
 ```
   @Cordova()
-  static getCurrentPosition(options?: GeolocationOptions): Promise<Geoposition> { return }
+  getCurrentPosition(options?: GeolocationOptions): Promise<Geoposition> { return }
 ```
 
 It's just a stub. The `return` is only there to keep the TypeScript type-checker from complaining since we indicate that `getCurrentPosition` returns a `Promise<Geoposition>`.
 
-By default, the `@Cordova` decorator wraps the plugin callbacks in a Promise that resolves when the success callback is called and rejects when the error callback is called.  It also ensures that Cordova and the underlying plugin are available, and prints helpful diagnostics if they aren't.
-
-You'll also notice that `getCurrentPosition` is a static method. That's because the plugin class is just a utility class to call the underlying Cordova plugin methods, it's not an instance and has no state.
+By default, the `@Cordova` decorator wraps the plugin callbacks in a Promise that resolves when the success callback is called and rejects when the error callback is called. It also ensures that Cordova and the underlying plugin are available, and prints helpful diagnostics if they aren't.
 
 Next, let's look at the `watchPosition` method.
 
@@ -81,17 +95,139 @@ Next, let's look at the `watchPosition` method.
     observable: true,
     clearFunction: 'clearWatch'
   })
-  static watchPosition(options?: GeolocationOptions): Observable<Geoposition> { return }
+  watchPosition(options?: GeolocationOptions): Observable<Geoposition> { return }
 ```
 
 The `@Cordova` decorator has a few more options now.
 
-`observable` indicates that this method may call its callbacks multiple times, so `@Cordova` wraps it in an [`Observable`](https://github.com/driftyco/ionic-native#promises-and-observables) instead of a Promise.
+`observable` indicates that this method may call its callbacks multiple times, so `@Cordova` wraps it in an [`Observable`](https://github.com/ionic-team/ionic-native#promises-and-observables) instead of a Promise.
 
-`callbackOrder` refers to the method signature of the underlying Cordova plugin, and tells Ionic Native which arguments are the callbacks to map to the wrapping Promise or Observable.  In this case, the signature is [`watchPosition(success, error, options)`](https://github.com/apache/cordova-plugin-geolocation#navigatorgeolocationwatchposition), so we need to tell `@Cordova` that the callbacks are the first arguments, not the last arguments.  For rare cases, you can also specify the options `successIndex` and `errorIndex` to indicate where in the argument list the callbacks are located.
+`callbackOrder` refers to the method signature of the underlying Cordova plugin, and tells Ionic Native which arguments are the callbacks to map to the wrapping Promise or Observable. In this case, the signature is [`watchPosition(success, error, options)`](https://github.com/apache/cordova-plugin-geolocation#navigatorgeolocationwatchposition), so we need to tell `@Cordova` that the callbacks are the first arguments, not the last arguments. For rare cases, you can also specify the options `successIndex` and `errorIndex` to indicate where in the argument list the callbacks are located.
 
 `clearFunction` is used in conjunction with the `observable` option and indicates the function to be called when the Observable is disposed.
 
+### Testing your changes
+
+You need to run `npm run build` in the `ionic-native` project, this will create a `dist` directory. The `dist` directory will contain a sub directory `@ionic-native` with all the packages compiled in there. Copy the package(s) you created/modified to your app's node_modules under the `@ionic-native` directory. (e.g. `cp -r dist/@ionic-native/plugin-name ../my-app/node_modules/@ionic-native/`).
+
+### Cleaning the code
+
+You need to run `npm run lint` to analyze the code and ensure its consistency with the repository style. Fix any errors before submitting a PR.
+
 ### 'Wrapping' Up
 
-That's it! The only thing left to do is rigorously document the plugin and it's usage.  Take a look at some of the other plugins for good documentation styles.
+That's it! The only thing left to do is rigorously document the plugin and its usage. Take a look at some of the other plugins for good documentation styles.
+
+## Commit Message Format
+
+We have very precise rules over how our git commit messages can be formatted. This leads to more readable messages that are easy to follow when looking through the project history. But also, we use the git commit messages to generate the our change log. (Ok you got us, it's basically Angular's commit message format).
+
+`type(scope): subject`
+
+#### Type
+
+Must be one of the following:
+
+- **fix**: A bug fix
+- **feat**: A new feature
+- **docs**: Documentation only changes
+- **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- **refactor**: A code change that neither fixes a bug nor adds a feature
+- **perf**: A code change that improves performance
+- **test**: Adding missing tests
+- **chore**: Changes to the build process or auxiliary tools and libraries such as documentation generation
+
+#### Scope
+
+The scope could be anything specifying place of the commit change. For example, the name of the plugin being changed
+
+#### Subject
+
+The subject contains succinct description of the change:
+
+- use the imperative, present tense: "change" not "changed" nor "changes"
+- do not capitalize first letter
+- do not place a period (.) at the end
+- entire length of the commit message must not go over 50 characters
+
+### Ionic Native Decorators
+
+#### Plugin
+
+A decorator to wrap the main plugin class, and any other classes that will use `@Cordova` or `@CordovaProperty` decorators. This decorator accepts the following configuration:
+
+- _pluginName_: Plugin name, this should match the class name
+- _plugin_: The plugin's NPM package, or Github URL if NPM is not available.
+- _pluginRef_: The plugin object reference. Example: 'cordova.file'.
+- _repo_: The plugin's Github Repository URL
+- _install_: (optional) Install command. This is used in case a plugin has a custom install command (takes variables).
+- _platforms_: An array of strings indicating the supported platforms.
+
+#### Cordova
+
+Checks if the plugin and the method are available before executing. By default, the decorator will wrap the callbacks of the function and return a Promise. This decorator takes the following configuration options:
+
+- **observable**: set to true to return an Observable
+- **methodName**: an optional name of the cordova plugins method name (if different from wrappers method name)
+- **clearFunction**: an optional name of a method to clear the observable we returned
+- **clearWithArgs**: This can be used if clearFunction is set. Set this to true to call the clearFunction with the same arguments used in the initial function.
+- **sync**: set to true if the method should return the value as-is without wrapping with Observable/Promise
+- **callbackOrder**: set to `reverse` if the success and error callbacks are the first two arguements of the method
+- **callbackStyle**: set to `node` if the plugin has one callback with a node style (e.g: `function(err, result){}`), or set to `object` if the callbacks are part of an object
+- **successName**: Success function property name. This must be set if callbackStyle is set to object.
+- **errorName**: Error function property name. This must be set if callbackStyle is set to object.
+- **successIndex**: Set a custom index for the success callback function. This doesn't work if callbackOrder or callbackStyle are set.
+- **errorIndex**: Set a custom index for the error callback function. This doesn't work if callbackOrder or callbackStyle are set.
+- **eventObservable**: set to true to return an observable that wraps an event listener
+- **event**: Event name, this must be set if eventObservable is set to true
+- **element**: Element to attach the event listener to, this is optional, defaults to `window`
+- **otherPromise**: Set to true if the wrapped method returns a promise
+- **platforms**: array of strings indicating supported platforms. Specify this if the supported platforms doesn't match the plugin's supported platforms.
+
+Example:
+
+```ts
+@Cordova()
+someMethod(): Promise<any> { return; }
+
+@Cordova({ sync: true })
+syncMethod(): number { }
+```
+
+#### CordovaProperty
+
+Checks if the plugin and property exist before getting/setting the property's value
+
+Example:
+
+```ts
+@CordovaProperty()
+someProperty: string;
+```
+
+#### CordovaCheck
+
+Checks if the plugin exists before performing a custom written method. By default, the method will return a promise that will reject with an error if the plugin is not available. This wrapper accepts two optional configurations:
+
+- **observable**: set to true to return an empty Observable if the plugin isn't available
+- **sync**: set to true to return nothing if the plugin isn't available
+
+Example:
+
+```ts
+@CordovaCheck()
+someMethod(): Promise<any> {
+  // anything here will only run if the plugin is available
+}
+```
+
+#### CordovaFunctionOverride
+
+Wrap a stub function in a call to a Cordova plugin, checking if both Cordova and the required plugin are installed.
+
+Example:
+
+```ts
+@CordovaFunctionOverride()
+someMethod(): Observable<any> { return; }
+```

LICENSE

@@ -0,0 +1,23 @@
+Copyright 2015-present Drifty Co.
+http://drifty.com/
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,55 +1,273 @@
-[![Circle CI](https://circleci.com/gh/driftyco/ionic-native.svg?style=shield)](https://circleci.com/gh/driftyco/ionic-native) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
-[![npm](https://img.shields.io/npm/l/express.svg)](https://www.npmjs.com/package/ionic-native-playground)
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) ![](https://img.shields.io/npm/v/@awesome-cordova-plugins/core.svg)
 
-[![NPM](https://nodei.co/npm/ionic-native.png?stars&downloads)](https://nodei.co/npm/ionic-native/)
+# Awesome Cordova Plugins
 
+Awesome Cordova Plugins is a curated set of wrappers for Cordova plugins that make adding any native functionality you need to your [Ionic](https://ionicframework.com/) mobile app easy.
 
-# Ionic Native
+Awesome Cordova Plugins wraps plugin callbacks in a Promise or Observable, providing a common interface for all plugins and making it easy to use plugins with Angular change detection.
 
-Ionic Native is a curated set of wrappers for Cordova plugins that make adding any native functionality you need to your [Ionic](http://ionicframework.com/), Cordova, or Web View mobile app easy.
+To learn more about the reasons why Ionic Native was renamed to Awesome Cordova Plugins, read the official [Ionic blog](https://ionicframework.com/blog/a-new-chapter-for-ionic-native/) post by Max Lyncht.
 
-### Promises and Observables
+## Capacitor Support
 
-Ionic Native wraps plugin callbacks in a Promise or [Observable](https://gist.github.com/staltz/868e7e9bc2a7b8c1f754), providing a common interface for all plugins and ensuring that native events trigger change detection in Angular 2.
+In addition to Cordova, Awesome Cordova Plugins also works with [Capacitor](https://capacitor.ionicframework.com), Ionic's official native runtime. Basic usage below. For complete details, [see the Capacitor documentation](https://capacitor.ionicframework.com/docs/cordova/using-cordova-plugins).
 
+## Installation
+
+Run following command to install Awesome Cordova Plugins in your project.
+
+```bash
+npm install @awesome-cordova-plugins/core --save
 ```
-import {Geolocation} from 'ionic-native';
 
-Geolocation.getCurrentPosition().then(pos => { 
-  console.log('lat: ' + pos.coords.latitude + ', lon: ' + pos.coords.longitude);
+You also need to install the Awesome Cordova Plugins package for each plugin you want to add. Please see the [Awesome Cordova Plugins documentation](https://ionicframework.com/docs/native/) for complete instructions on how to add and use the plugins.
+
+## Documentation
+
+For the full Awesome Cordova Plugins documentation, please visit [https://ionicframework.com/docs/native/](https://ionicframework.com/docs/native/).
+
+### Basic Usage
+
+#### Ionic/Angular apps
+
+To use a plugin, import and add the plugin provider to your `@NgModule`, and then inject it where you wish to use it.
+Make sure to import the injectable class from the `/ngx` directory as shown in the following examples:
+
+```typescript
+// app.module.ts
+import { Camera } from '@awesome-cordova-plugins/camera/ngx';
+
+...
+
+@NgModule({
+  ...
+
+  providers: [
+    ...
+    Camera
+    ...
+  ]
+  ...
+})
+export class AppModule { }
+```
+
+```typescript
+import { Geolocation } from '@awesome-cordova-plugins/geolocation/ngx';
+import { Platform } from 'ionic-angular';
+
+@Component({ ... })
+export class MyComponent {
+
+  constructor(private geolocation: Geolocation, private platform: Platform) {
+
+    this.platform.ready().then(() => {
+
+      // get position
+      this.geolocation.getCurrentPosition().then(pos => {
+        console.log(`lat: ${pos.coords.latitude}, lon: ${pos.coords.longitude}`)
+      });
+
+
+      // watch position
+      const watch = geolocation.watchPosition().subscribe(pos => {
+        console.log(`lat: ${pos.coords.latitude}, lon: ${pos.coords.longitude}`)
+      });
+
+      // to stop watching
+      watch.unsubscribe();
+    });
+
+  }
+
+}
+```
+
+#### Ionic/React apps
+
+React apps must use Capacitor to build native mobile apps. However, Awesome Cordova Plugins (and therefore, Cordova plugins) can still be used.
+
+```bash
+# Install Core library (once per project)
+npm install @awesome-cordova-plugins/core
+
+# Install Awesome Cordova Plugins TypeScript wrapper
+npm install @awesome-cordova-plugins/barcode-scanner
+
+# Install Cordova plugin
+npm install phonegap-plugin-barcodescanner
+
+# Update native platform project(s) to include newly added plugin
+ionic cap sync
+```
+
+Import the plugin object then use its static methods:
+
+```typescript
+import { BarcodeScanner } from '@awesome-cordova-plugins/barcode-scanner';
+
+const Tab1: React.FC = () => {
+  const openScanner = async () => {
+    const data = await BarcodeScanner.scan();
+    console.log(`Barcode data: ${data.text}`);
+  };
+  return (
+    <IonPage>
+      <IonHeader>
+        <IonToolbar>
+          <IonTitle>Tab 1</IonTitle>
+        </IonToolbar>
+      </IonHeader>
+      <IonContent>
+        <IonButton onClick={openScanner}>Scan barcode</IonButton>
+      </IonContent>
+    </IonPage>
+  );
+};
+```
+
+#### ES2015+/TypeScript
+
+These modules can work in any ES2015+/TypeScript app (including Angular/Ionic apps). To use any plugin, import the class from the appropriate package, and use it's static methods.
+
+```js
+import { Camera } from '@awesome-cordova-plugins/camera';
+
+document.addEventListener('deviceready', () => {
+  Camera.getPicture()
+    .then((data) => console.log('Took a picture!', data))
+    .catch((e) => console.log('Error occurred while taking a picture', e));
 });
+```
 
-let watch = Geolocation.watchPosition();
-watch.subscribe(pos => {
-  console.log('lat: ' + pos.coords.latitude + ', lon: ' + pos.coords.longitude);
+#### AngularJS
+
+Awesome Cordova Plugins generates an AngularJS module in runtime and prepares a service for each plugin. To use the plugins in your AngularJS app:
+
+1. Download the latest bundle from the [Github releases](https://github.com/danielsogl/awesome-cordova-plugins/releases) page.
+2. Include it in `index.html` before your app's code.
+3. Inject `ionic.native` module in your app.
+4. Inject any plugin you would like to use with a `$cordova` prefix.
+
+```js
+angular.module('myApp', ['ionic.native']).controller('MyPageController', function ($cordovaCamera) {
+  $cordovaCamera.getPicture().then(
+    function (data) {
+      console.log('Took a picture!', data);
+    },
+    function (err) {
+      console.log('Error occurred while taking a picture', err);
+    }
+  );
 });
+```
 
-// to stop watching
-watch.unsubscribe();
+#### Vanilla JS
+
+To use Awesome Cordova Plugins in any other setup:
+
+1. Download the latest bundle from the [Github releases](https://github.com/danielsogl/awesome-cordova-plugins/releases) page.
+2. Include it in `index.html` before your app's code.
+3. Access any plugin using the global `IonicNative` variable.
+
+```js
+document.addEventListener('deviceready', function () {
+  IonicNative.Camera.getPicture().then(
+    function (data) {
+      console.log('Took a picture!', data);
+    },
+    function (err) {
+      console.log('Error occurred while taking a picture', err);
+    }
+  );
+});
+```
+
+### Mocking and Browser Development (Ionic/Angular apps only)
+
+Awesome Cordova Plugins makes it possible to mock plugins and develop nearly the entirety of your app in the browser or in `ionic serve`.
+
+To do this, you need to provide a mock implementation of the plugins you wish to use. Here's an example of mocking the `Camera` plugin to return a stock image while in development:
+
+First import the `Camera` class in your `src/app/app.module.ts` file:
+
+```typescript
+import { Camera } from '@awesome-cordova-plugins/camera/ngx';
+```
+
+Then create a new class that extends the `Camera` class with a mock implementation:
+
+```typescript
+class CameraMock extends Camera {
+  getPicture(options) {
+    return new Promise((resolve, reject) => {
+      resolve('BASE_64_ENCODED_DATA_GOES_HERE');
+    });
+  }
+}
+```
+
+Finally, override the previous `Camera` class in your `providers` for this module:
+
+```typescript
+providers: [{ provide: Camera, useClass: CameraMock }];
+```
+
+Here's the full example:
+
+```typescript
+import { ErrorHandler, NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { IonicApp, IonicModule, IonicErrorHandler } from 'ionic-angular';
+import { MyApp } from './app.component';
+import { HomePage } from '../pages/home/home';
+
+import { Camera } from '@awesome-cordova-plugins/camera/ngx';
+
+import { HomePage } from '../pages/home/home';
+import { MyApp } from './app.component';
+
+class CameraMock extends Camera {
+  getPicture(options) {
+    return new Promise((resolve, reject) => {
+      resolve('BASE_64_ENCODED_DATA_GOES_HERE');
+    });
+  }
+}
+
+@NgModule({
+  declarations: [MyApp, HomePage],
+  imports: [BrowserModule, IonicModule.forRoot(MyApp)],
+  bootstrap: [IonicApp],
+  entryComponents: [MyApp, HomePage],
+  providers: [
+    { provide: ErrorHandler, useClass: IonicErrorHandler },
+    { provide: Camera, useClass: CameraMock },
+  ],
+})
+export class AppModule {}
 ```
 
 ### Runtime Diagnostics
 
-Spent way too long diagnosing an issue only to realize a plugin wasn't firing or installed? Ionic Native lets you know what the issue is and how you can resolve it.
-
-## Installation
-
-Run following commmand to install ionic-native in your project. 
-```
-npm install ionic-native --save
-```
+Spent way too long diagnosing an issue only to realize a plugin wasn't firing or installed? Awesome Cordova Plugins lets you know what the issue is and how you can resolve it.
 
+![img](https://ionic-io-assets.s3.amazonaws.com/ionic-native-console.png)
 
 ## Plugin Missing?
-Let us know or submit a PR! Take a look at [the Developer Guide](https://github.com/driftyco/ionic-native/blob/master/DEVELOPER.md) for more on how to contribute. :heart:
 
+Let us know or submit a PR! Take a look at [the Developer Guide](https://github.com/danielsogl/awesome-cordova-plugins/blob/master/DEVELOPER.md) for more on how to contribute. :heart:
 
 # Credits
 
-Ibrahim Hadeed - [@ihadeed](http://github.com/ihadeed)
+Ibby Hadeed - [@ihadeed](https://github.com/ihadeed)
 
-Tim Lancina - [@timlancina](http://twitter.com/timlancina)
+Daniel Sogl - [@sogldaniel](https://twitter.com/sogldaniel)
 
-Max Lynch - [@maxlynch](http://twitter.com/maxlynch)
+Tim Lancina - [@timlancina](https://twitter.com/timlancina)
+
+Mike Hartington - [@mhartington](https://twitter.com/mhartington)
+
+Max Lynch - [@maxlynch](https://twitter.com/maxlynch)
 
 Rob Wormald - [@robwormald](https://twitter.com/robwormald)

circle.yml

@@ -1,27 +0,0 @@
-machine:
-  node:
-    version: 4.1.0
-  ruby:
-    version: 2.1.2
-
-general:
-  branches:
-    only:
-      - master # ignore PRs and branches
-
-#dependencies:
-#  pre:
-#    - ./scripts/docs/prepare.sh
-#  cache_directories:
-#    - "~/ionic-site" # cache ionic-site
-
-test:
-  override:
-    - echo "No tests are written at the moment. But we will attempt to build the library with the latest changes."
-    - npm run build_bundle
-
-#deployment:
-#  staging:
-#    branch: master
-#    commands:
-#      - ./scripts/docs/update_docs.sh

demo/.gitignore

@@ -1,31 +0,0 @@
-# Specifies intentionally untracked files to ignore when using Git
-# http://git-scm.com/docs/gitignore
-
-*~
-*.sw[mnpcod]
-*.log
-*.tmp
-*.tmp.*
-log.txt
-*.sublime-project
-*.sublime-workspace
-
-.idea/
-.sass-cache/
-.versions/
-coverage/
-dist/
-node_modules/
-tmp/
-temp/
-hooks/
-platforms/
-plugins/
-plugins/android.json
-plugins/ios.json
-www/build/
-$RECYCLE.BIN/
-
-.DS_Store
-Thumbs.db
-UserInterfaceState.xcuserstate

demo/README.md

@@ -1,72 +0,0 @@
-## Getting Started
-
-`ionic serve`
-
-The `ionic serve` command compiles your ES6 files to ES5, your Sass files to CSS, bundles it all up for you, opens up a browser window and serves your app locally.  After the initial build it will watch for changes and automatically rebuild and reload.  The build output can be configured in your `ionic.config.js` file (which will be autogenerated by `ionic serve` if it doesn't exist yet).
-
-#### Updating Ionic
-When you start your project with `ionic start`, the latest version of `ionic-framework` is installed automatically. To update your ionic version in an existing project, run `npm install --save ionic-framework@latest`. This will install the latest version of `ionic-framework` published to npm, and save it in your `package.json` file so if you are checking your project in to version control the correct version of the framework will be installed by [`npm install`](https://docs.npmjs.com/cli/install).
-
-#### Developing Against Unstable Master
-- THIS IS NOT UPDATING YOUR APP. THIS IS FOR DEVELOPING AGAINST THE UNSTABLE MASTER BRANCH, WHICH WE DO NOT RECOMMEND. SEE [Updating Ionic](#updating-ionic) FOR INSTRUCTIONS ON UPDATING TO THE LATEST VERSION OF THE FRAMEWORK. To develop against a local version of ionic-framework (master) you'll need to do the following:
-```bash
-# if you haven't already, clone the ionic2 repo:
-$ git clone https://github.com/driftyco/ionic2.git
-$ cd ionic2
-$ npm install
-$ gulp src # build the source files
-$ npm link
-
-# now go to your app directory
-$ cd /Users/Ionitron/git/MyIonic2App
-$ npm link ionic-framework
-```
-And then update your [`webpack.config.js`](https://github.com/driftyco/ionic2-app-base/blob/master/webpack.config.js#L68) file by uncommenting the lines for local development:
-```js
-resolve: {
-  modulesDirectories: [
-    "node_modules",
-    "node_modules/ionic-framework/node_modules", 
-    "node_modules/ionic-framework/dist/src/es5/common", 
-    "node_modules/ionic-framework/dist/js", 
-
-    "dist/src/es5/common" // <--- Uncomment me  
-  ],
-}
-```
-Update the ionic2 [`gulpfile.js #L141`](https://github.com/driftyco/ionic2/blob/master/gulpfile.js#L141) to this in order to use `gulp watch` and make changes to the ionic2 repo:
-```js
-gulp.start('transpile.common');
-```
-
-
-### Missing Ionic 1 features
-
-We are currently working on completing a few core Ionic 1 features:
-
-- Collection repeat (known as Virtual Scrolling in v2) is not quite ready
-
-### Current Angular 2 known issues:
-
-- Angular 2 is still in alpha and is not production ready
-- Angular team has first focused on developing what the core of Angular 2 "is"
-- Angular 2 filesize has not been optimized for minification yet
-- Angular 2 bootstrap time has not been optimized yet
-- As Angular 2 reaches beta there will be significant performance improvements
-
-
-### ES6/Typescript
-
-- Ionic's source is written using [Typescript](http://www.typescriptlang.org/)
-- Ionic apps can be written in ES6 or TypeScript
-- Typescript is an optional feature to be used at the developers discretion
-- Ionic 2 starters come with the necessary build tools to transpile both ES6 and Typescript
-
-
-### CSS Attribute Selectors:
-
-- Simple
-- Smaller markup
-- Easier to read and understand
-- [Not an issue](https://twitter.com/paul_irish/status/311610425617838081) for today's mobile browsers
-- No performance impacts have been found

demo/config.xml

@@ -1,33 +0,0 @@
-<?xml version='1.0' encoding='utf-8'?>
-<widget id="io.ionic.nativeDemo" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
-    <name>V2 Test</name>
-    <description>An Ionic Framework and Cordova project.</description>
-    <author email="hi@ionicframework" href="http://ionicframework.com/">Ionic Framework Team</author>
-    <content src="index.html" />
-    <access origin="*" />
-    <allow-intent href="http://*/*" />
-    <allow-intent href="https://*/*" />
-    <allow-intent href="tel:*" />
-    <allow-intent href="sms:*" />
-    <allow-intent href="mailto:*" />
-    <allow-intent href="geo:*" />
-    <platform name="android">
-        <allow-intent href="market:*" />
-    </platform>
-    <platform name="ios">
-        <allow-intent href="itms:*" />
-        <allow-intent href="itms-apps:*" />
-    </platform>
-    <preference name="webviewbounce" value="false" />
-    <preference name="UIWebViewBounce" value="false" />
-    <preference name="DisallowOverscroll" value="true" />
-    <preference name="android-minSdkVersion" value="16" />
-    <preference name="BackupWebStorage" value="none" />
-    <feature name="StatusBar">
-        <param name="ios-package" onload="true" value="CDVStatusBar" />
-    </feature>
-    <plugin name="cordova-plugin-facebook4" spec="~1.3.0-0">
-        <variable name="APP_ID" value="279000342284434" />
-        <variable name="APP_NAME" value="ngCordova Test" />
-    </plugin>
-</widget>

demo/ionic.config.js

@@ -1,16 +0,0 @@
-module.exports = {
-  name: 'demo',
-  proxies: null,
-
-  // hooks execute before or after all project-related Ionic commands
-  // (so not for start, docs, but serve, run, etc.) and take in the arguments
-  // passed to the command as a parameter
-  //
-  // The format is 'before' or 'after' + commandName (uppercased)
-  // ex: beforeServe, afterRun, beforePrepare, etc.
-  hooks: {
-    // beforeServe: function(argv) {
-    //   console.log('Arguments to ionic serve: "' + argv._ + '"');
-    // }
-  }
-}

demo/ionic.project

@@ -1,4 +0,0 @@
-{
-  "name": "demo",
-  "app_id": ""
-}

demo/package.json

@@ -1,33 +0,0 @@
-{
-  "devDependencies": {
-    "autoprefixer-loader": "^3.1.0",
-    "awesome-typescript-loader": "0.12.0-rc.2",
-    "css-loader": "^0.22.0",
-    "file-loader": "^0.8.4",
-    "node-sass": "^3.4.2",
-    "resolve-url-loader": "^1.4.2",
-    "sass-loader": "^3.1.1",
-    "style-loader": "^0.13.0",
-    "typescript": "1.5.3",
-    "url-loader": "^0.5.6",
-    "webpack": "^1.12.4"
-  },
-  "dependencies": {
-    "ionic-framework": "2.0.0-alpha.35",
-    "ionic-native": "^1.0.7"
-  },
-  "name": "demo",
-  "description": "demo: An Ionic project",
-  "cordovaPlugins": [
-    "cordova-plugin-x-toast",
-    "cordova-plugin-device",
-    "cordova-plugin-console",
-    "cordova-plugin-whitelist",
-    "cordova-plugin-splashscreen",
-    "cordova-plugin-statusbar",
-    "ionic-plugin-keyboard"
-  ],
-  "cordovaPlatforms": [
-    "ios"
-  ]
-}

demo/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES5",
-    "allowNonTsExtensions": true,
-    "module": "commonjs",
-    "sourceMap": true,
-    "isolatedModules": true,
-    "noEmitOnError": false,
-    "rootDir": ".",
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true
-  },
-  "compileOnSave": false
-}

demo/webpack.config.js

@@ -1,80 +0,0 @@
-var path = require('path');
-
-var autoprefixerOptions = {
-    browsers: [
-      'last 2 versions',
-      'iOS >= 7',
-      'Android >= 4',
-      'Explorer >= 10',
-      'ExplorerMobile >= 11'
-    ],
-    cascade: false
-  }
-
-module.exports = {
-  entry: [
-    "es6-shim",
-    "reflect-metadata",
-    "web-animations.min",
-    "zone.js",
-    path.join(__dirname, 'www', 'app', 'app.js')
-  ],
-  output: {
-    path: path.join(__dirname, 'www', 'build', 'js'),
-    filename: 'app.bundle.js',
-    publicPath: 'build/js/'
-    //pathinfo: true // show module paths in the bundle, handy for debugging
-  },
-  module: {
-    loaders: [
-      {
-        test: /\.js$/,
-        loader: "awesome-typescript-loader?doTypeCheck=false&useWebpackText=true",
-        include: [path.join(__dirname, 'www')],
-        exclude: /node_modules/
-      },
-      {
-        test: /\.ts$/,
-        loader: "awesome-typescript-loader",
-        include: [path.join(__dirname, 'www')],
-        exclude: /node_modules/
-      },
-      { 
-        // Loader to compile all of our SASS down. 
-        // Use the `resolve-url` pipe to convert the relative url paths to something this loader
-        // can work with, e.g.: url('../my-file.png') => url('/path/to/my-file.png')
-        // https://github.com/bholloway/resolve-url-loader
-        test: /\.scss$/,
-        loaders: [
-          "style",
-          "css",
-          "autoprefixer?" + JSON.stringify(autoprefixerOptions),
-          "resolve-url",
-          "sass?sourceMap"
-        ]
-      },
-      // Any png-image or woff-font below or equal to 100K will be converted 
-      // to inline base64 instead
-      { test: /\.(png|woff|ttf)$/, loader: 'url-loader?limit=100000' }
-    ]
-  },
-  resolve: {
-    modulesDirectories: [
-      "node_modules",
-      "node_modules/ionic-framework/node_modules", // angular is a dependency of ionic
-      "node_modules/ionic-framework/dist/js", // for web-animations polyfill
-      "node_modules/ionic-framework/dist/src/es5/common" // ionic-framework npm package (stable)
-      // See README for steps on developing against ionic-framework locally
-      // "dist/src/es5/common" // when developing against locally linked ionic-framework (master)
-    ],
-    extensions: ["", ".js", ".ts"]
-  },
-  // Sass loader configuration to tell webpack where to find the additional SASS files
-  // it needs for `ionic`, located in the ionic-framework node module folder.
-  // https://github.com/jtangelder/sass-loader#sass-options
-  sassLoader: {
-    includePaths: [
-      path.resolve(__dirname, "node_modules", 'ionic-framework', 'dist', 'src', 'scss')
-    ]
-  }
-};

demo/www/app/app.js

@@ -1,27 +0,0 @@
-import {App, Platform} from 'ionic/ionic';
-import {HomePage} from './home/home';
-import './app.scss';
-
-import {StatusBar} from 'ionic-native';
-
-@App({
-  template: `
-    <ion-nav [root]="root"></ion-nav>
-    <ion-overlay></ion-overlay>
-  `,
-})
-export class MyApp {
-  constructor(platform: Platform) {
-    this.platform = platform;
-    this.initializeApp();
-    this.root = HomePage;
-
-  }
-
-  initializeApp() {
-    this.platform.ready().then(() => {
-      console.log('Platform ready');
-      StatusBar.styleDefault();
-    });
-  }
-}

demo/www/app/app.scss

@@ -1,24 +0,0 @@
-// To customize the look and feel of Ionic, you can override
-// the Sass variables found in Ionic's source scss files.
-
-// App Color Variables
-// ---------------------------------
-// It's highly recommended to change the default colors
-// to match your app's branding. Ionic uses a Sass map of
-// colors so you can add, rename and remove colors as needed.
-// The "primary" color is the only required color in the map.
-
-$colors: (primary: #387ef5, secondary: #32db64, danger: #f53d3d, light: #f4f4f4, dark: #222222);
-
-// Ionic Sass
-// ---------------------------------
-@import "ionic";
-
-// App Sass
-// ---------------------------------
-// It is recommended to do all of your imports in your files to let webpack build them
-// in a module like manner.
-// For example - instead of adding the @imports here, create a sass file 
-// in ./tabs/tabs.scss - then @import your variables there, along with any custom styles.
-// Webpack only rebuilds that specific sass file on changes, 
-// and not the entire bundle, making rebuild times much faster for sass changes

demo/www/app/home/home.html

@@ -1,13 +0,0 @@
-<ion-navbar *navbar>
-  <ion-title>
-    Ionic Native
-  </ion-title>
-</ion-navbar>
-
-<ion-content>
-  <ion-list>
-    <button ion-item *ng-for="#plugin of plugins" (click)="choosePlugin(plugin)">
-      {{plugin.name}}
-    </button>
-  </ion-list>
-</ion-content>

demo/www/app/home/home.js

@@ -1,51 +0,0 @@
-import {Page, NavController} from 'ionic/ionic'
-
-import {
-  ActionSheet,
-  BarcodeScanner,
-  BLE,
-  Camera,
-  Calendar,
-  Contacts,
-  Device,
-  Facebook,
-  Geolocation,
-  Push,
-  StatusBar,
-  Toast,
-  TouchID
-} from 'ionic-native';
-
-import {Plugin} from '../plugin/plugin';
-
-@Page({
-  templateUrl: 'app/home/home.html',
-})
-export class HomePage {
-  constructor(nav: NavController) {
-    this.nav = nav;
-
-    this.plugins = [
-      ActionSheet,
-      BarcodeScanner,
-      BLE,
-      Camera,
-      Calendar,
-      Contacts,
-      Device,
-      Facebook,
-      Geolocation,
-      Push,
-      StatusBar,
-      Toast,
-      TouchID
-    ];
-    console.log('PLUGINS', this.plugins);
-  }
-
-  choosePlugin(plugin) {
-    this.nav.push(Plugin, {
-      plugin: plugin
-    });
-  }
-}

demo/www/app/plugin/plugin.html

@@ -1,16 +0,0 @@
-<ion-navbar *navbar>
-  <ion-title>
-    {{plugin.name}}
-  </ion-title>
-</ion-navbar>
-
-<ion-content>
-  <ion-input fixed-label>
-    <textarea [(ng-model)]="content.value" style="height: 150px; font-size: 11px" placeholder="Plugin output will go here as you test methods..."></textarea>
-  </ion-input>
-  <ion-list>
-    <button ion-item *ng-for="#method of methods" (click)="doMethod(method)">
-      {{method}}()
-    </button>
-  </ion-list>
-</ion-content>

demo/www/app/plugin/plugin.js

@@ -1,172 +0,0 @@
-import {ElementRef} from 'angular2/angular2';
-
-import {Page, NavParams} from 'ionic/ionic';
-
-import {Camera, Calendar, StatusBar, Toast, ActionSheet, Facebook, Push} from 'ionic-native';
-
-import {safeJSONStringify} from '../util';
-
-// To specify arguments for any plugin calls
-var demoArgs = {};
-demoArgs[ActionSheet] = {
-  show: {
-    'buttonLabels': ['Log out'],
-    'androidEnableCancelButton' : true, // default false
-    'winphoneEnableCancelButton' : true, // default false
-    'addCancelButtonWithLabel': 'Cancel'
-  }
-}
-
-demoArgs[Toast] = {
-  showWithOptions: [
-    {
-      message: "hey there",
-      duration: "short",
-      position: "bottom",
-      addPixelsY: -40  // added a negative value to move it up a bit (default 0)
-    }
-  ]
-}
-
-demoArgs[Facebook] = {
-  login: [
-    ["public_profile"]
-  ]
-};
-
-demoArgs[Push] = {
-  init: [{
-    android: {
-        senderID: "12345679"
-    },
-    ios: {
-        alert: "true",
-        badge: true,
-        sound: 'false'
-    },
-    windows: {}
-  }]
-}
-
-var demoCode = {};
-
-demoCode[Calendar] = {
-  createEventInteractively: function() {
-    Calendar.createEventInteractively("Grab Coffee", "Johnson Public House", new Date(), new Date()).then((event) => {
-      console.log("Created event", event);
-      this.output('Created event', event);
-    })
-  }
-};
-demoCode[Facebook] = {
-  login: function() {
-    Facebook.login(["public_profile"]).then((userData) => {
-      console.log("Facebook UserInfo: ", userData);
-      this.output('Facebook UserInfo: ', userData);
-      Facebook.getAccessToken().then((token) => {
-        this.output('Facebook Token: ', token);
-        console.log("Token: " + token);
-      });
-    }, (err) => {
-      console.error(err);
-    });
-  }
-}
-
-
-@Page({
-  templateUrl: 'app/plugin/plugin.html',
-})
-export class Plugin {
-  constructor(params: NavParams, elementRef: ElementRef) {
-
-    let el = elementRef.nativeElement;
-
-    this.textArea = el.querySelector('textarea');
-
-    this.content = {
-      items: [],
-      value: ''
-    };
-
-    this.plugin = params.get('plugin');
-    console.log('Plugin', this.plugin);
-
-    this.methods = Object.keys(this.plugin).filter((k) => {
-      if(typeof this.plugin[k] === 'function') {
-        return true;
-      }
-      return false;
-    });
-  }
-
-  output(...args) {
-    var s = args.map((v) => {
-      if(typeof v === 'object') {
-        console.log('Stringifying', v);
-        return safeJSONStringify(v, 4);//JSON.stringify(v);
-      }
-      return v;
-    });
-
-    this.content.items.push(s.join(' '));
-
-    this.content.value = this.content.items.join();
-
-    setTimeout(() => {
-      this.textArea.scrollTop = this.textArea.scrollHeight;
-    })
-  }
-
-  doMethod(method) {
-    let pluginMethodArgEntry = demoArgs[this.plugin];
-    let pluginCodeEntry = demoCode[this.plugin] && demoCode[this.plugin][method];
-
-    let args = [];
-    if(pluginMethodArgEntry) {
-      args = [pluginMethodArgEntry[method]] || [];
-      console.log('Found some default args', args);
-    }
-
-    Toast.showWithOptions({
-      message: 'Doing ' + this.plugin.name + '.' + method + '()',
-      duration: "short",
-      position: "bottom",
-      addPixelsY: -40  // added a negative value to move it up a bit (default 0)
-    });
-    console.log('Doing method', method, 'on Plugin', this.plugin, 'args:', args);
-
-    // Run the custom code
-    if(pluginCodeEntry) {
-      pluginCodeEntry.apply(this);
-      return;
-    }
-
-    let v = this.plugin[method].apply(this.plugin, args);
-
-    if(v && v.then) {
-      v.then(() => {
-        console.log('Success', arguments, this);
-        this.output(arguments);
-      }, (err) => {
-        console.error('Error', err);
-        this.output(err);
-      });
-    } else {
-      console.log('Response: ', v);
-      this.output(v);
-
-      if(v.subscribe) {
-        console.log('Observable response, subscribing...');
-        v.subscribe((val) => {
-          console.log('Observable val', val);
-          this.output(val);
-        }, (err) => {
-          this.output(err);
-          console.log('ERROR: Observable', err);
-        });
-      }
-    }
-  }
-
-}

demo/www/app/util.js

@@ -1,68 +0,0 @@
-export function safeJSONStringify (input, maxDepth)
-{
-
-  var output,
-  refs = [],
-  refsPaths = [];
-
-  maxDepth = maxDepth || 5;
-
-  function recursion (input, path, depth)
-  {
-    var output = {},
-    pPath,
-    refIdx;
-
-    path  = path  || "";
-    depth = depth || 0;
-    depth++;
-
-    if (maxDepth && depth > maxDepth)
-    {
-      return "{depth over " + maxDepth + "}";
-    }
-
-    for (var p in input)
-    {
-      pPath = (path ? (path+".") : "") + p;
-      if (typeof input[p] === "function")
-      {
-        //output[p] = "{function}";
-      }
-      else if (typeof input[p] === "object")
-      {
-        /*
-        refIdx = refs.indexOf(input[p]);
-
-        if (-1 !== refIdx)
-        {
-          output[p] = recursion(input[p])"{reference to " + refsPaths[refIdx]  + "}";
-        }
-        else
-        {
-        */
-          refs.push(input[p]);
-          refsPaths.push(pPath);
-          output[p] = recursion(input[p], pPath, depth);
-        //}
-      }
-      else
-      {
-        output[p] = input[p];
-      }
-    }
-
-    return output;
-  }
-
-  if (typeof input === "object")
-  {
-    output = recursion(input);
-  }
-  else
-  {
-    output = input;
-  }
-
-  return JSON.stringify(output);
-}

demo/www/index.html

@@ -1,24 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-  <title>Ionic</title>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
-  <meta http-equiv="Content-Security-Policy" content="default-src 'self' data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *">
-  <meta name="format-detection" content="telephone=no">
-  <meta name="msapplication-tap-highlight" content="no">
-  <!--
-  Looking for a style sheet?
-  Webpack loads styles as dependencies in your javascript
-  See www/app/app.js as an example
-  -->
-</head>
-
-<body>
-  <ion-app></ion-app>
-  <script src="cordova.js"></script>
-  <script src="build/js/app.bundle.js"></script>
-</body>
-
-</html>

docs/SUMMARY.md

@@ -0,0 +1,221 @@
+# Table of contents
+
+* [Initial page](README.md)
+* [Plugins](plugins/README.md)
+  * [Push Notifications - WonderPush](plugins/wonderpush.md)
+  * [Kommunicate](plugins/kommunicate.md)
+  * [Power Optimization](plugins/power-optimization.md)
+  * [BLE](plugins/ble.md)
+  * [Text To Speech Advanced](plugins/text-to-speech-advanced.md)
+  * [NativeView](plugins/native-view.md)
+  * [Web Intent](plugins/web-intent.md)
+  * [Chooser](plugins/chooser.md)
+  * [Device](plugins/device.md)
+  * [Open Native Settings](plugins/open-native-settings.md)
+  * [CleverTap](plugins/clevertap.md)
+  * [PSPDFKit-Cordova](plugins/pspdfkit-cordova.md)
+  * [File Transfer](plugins/file-transfer.md)
+  * [AdMob Pro](plugins/admob-pro.md)
+  * [In App Update](plugins/in-app-update.md)
+  * [OpenALPR](plugins/openalpr.md)
+  * [AllInOneSDK](plugins/all-in-one-sdk.md)
+  * [AdMob](plugins/admob.md)
+  * [Native Keyboard](plugins/native-keyboard.md)
+  * [Vibes](plugins/vibes.md)
+  * [Safari View Controller](plugins/safari-view-controller.md)
+  * [Device Accounts](plugins/device-accounts.md)
+  * [Media Capture](plugins/media-capture.md)
+  * [Pollfish](plugins/pollfish.md)
+  * [OCR](plugins/ocr.md)
+  * [Fingerprint AIO](plugins/fingerprint-aio.md)
+  * [BiometricWrapper](plugins/biometric-wrapper.md)
+  * [Firebase Authentication](plugins/firebase-authentication.md)
+  * [Status Bar](plugins/status-bar.md)
+  * [BluetoothLE](plugins/bluetooth-le.md)
+  * [ZBar](plugins/zbar.md)
+  * [Android ExoPlayer](plugins/android-exoplayer.md)
+  * [Mobile Messaging](plugins/mobile-messaging.md)
+  * [Device Orientation](plugins/device-orientation.md)
+  * [Insomnia](plugins/insomnia.md)
+  * [Photo Library](plugins/photo-library.md)
+  * [Bluetooth Classic Serial Port](plugins/bluetooth-classic-serial-port.md)
+  * [Push](plugins/push.md)
+  * [FileTransferManager](plugins/background-upload.md)
+  * [App Center Analytics](plugins/app-center-analytics.md)
+  * [Anyline](plugins/anyline.md)
+  * [iOS DocumentPicker](plugins/document-picker.md)
+  * [Theme Detection](plugins/theme-detection.md)
+  * [DbResult](plugins/unvired-cordova-sdk.md)
+  * [Background Fetch](plugins/background-fetch.md)
+  * [Cloud Settings](plugins/cloud-settings.md)
+  * [Spotify Auth](plugins/spotify-auth.md)
+  * [Globalization](plugins/globalization.md)
+  * [FTP](plugins/ftp.md)
+  * [File](plugins/file.md)
+  * [Health](plugins/health.md)
+  * [Web Server](plugins/web-server.md)
+  * [Background Mode](plugins/background-mode.md)
+  * [Social Sharing](plugins/social-sharing.md)
+  * [Sms Retriever](plugins/sms-retriever.md)
+  * [Spinner Dialog](plugins/spinner-dialog.md)
+  * [System Alert Window Permission](plugins/system-alert-window-permission.md)
+  * [StarPRNT](plugins/star-prnt.md)
+  * [Badge](plugins/badge.md)
+  * [Launch Navigator](plugins/launch-navigator.md)
+  * [SumUp](plugins/sum-up.md)
+  * [Youtube Video Player](plugins/youtube-video-player.md)
+  * [Document Viewer](plugins/document-viewer.md)
+  * [Taptic Engine](plugins/taptic-engine.md)
+  * [ABBYY Real-Time Recognition](plugins/abbyy-rtr.md)
+  * [Media](plugins/media.md)
+  * [WebSocket Server](plugins/web-socket-server.md)
+  * [Firebase Messaging](plugins/firebase-messaging.md)
+  * [Music Controls](plugins/music-controls.md)
+  * [Calendar](plugins/calendar.md)
+  * [Call Directory](plugins/call-directory.md)
+  * [Iamport Cordova](plugins/iamport-cordova.md)
+  * [Video Editor](plugins/video-editor.md)
+  * [Tealium](plugins/tealium.md)
+  * [Camera Preview](plugins/camera-preview.md)
+  * [Firebase Analytics](plugins/firebase-analytics.md)
+  * [Image Picker](plugins/image-picker.md)
+  * [Shake](plugins/shake.md)
+  * [Local Notifications](plugins/local-notifications.md)
+  * [Android Permissions](plugins/android-permissions.md)
+  * [App Center Low Memory](plugins/app-center-low-memory.md)
+  * [App Center Push](plugins/app-center-push.md)
+  * [Native Audio](plugins/native-audio.md)
+  * [Geolocation](plugins/geolocation.md)
+  * [PayTabs](plugins/paytabs.md)
+  * [3D Touch](plugins/three-dee-touch.md)
+  * [FirebaseCrash](plugins/firebase-crash.md)
+  * [Toast](plugins/toast.md)
+  * [File Opener](plugins/file-opener.md)
+  * [PreviewAnyFile](plugins/preview-any-file.md)
+  * [SmartlookSetupConfigBuilder](plugins/smartlook.md)
+  * [Firebase Config](plugins/firebase-config.md)
+  * [Keychain](plugins/keychain.md)
+  * [WifiWizard2](plugins/wifi-wizard-2.md)
+  * [Header Color](plugins/header-color.md)
+  * [Dfu Update](plugins/dfu-update.md)
+  * [Sqlite Db Copy](plugins/sqlite-db-copy.md)
+  * [Gao De Location](plugins/gao-de-location.md)
+  * [DNS](plugins/dns.md)
+  * [Multiple Documents Picker](plugins/multiple-document-picker.md)
+  * [Lottie Splash Screen](plugins/lottie-splash-screen.md)
+  * [PlayInstallReferrer](plugins/play-install-referrer.md)
+  * [LocalBackup](plugins/local-backup.md)
+  * [Native Geocoder](plugins/native-geocoder.md)
+  * [Coordinates](plugins/hyper-track.md)
+  * [ApproovHTTP](plugins/approov-advanced-http.md)
+  * [Answers](plugins/fabric.md)
+  * [UriHelper](plugins/nfc.md)
+  * [Dialogs](plugins/dialogs.md)
+  * [Firebase Dynamic Links](plugins/firebase-dynamic-links.md)
+  * [Metrix](plugins/metrix.md)
+  * [Health Kit](plugins/health-kit.md)
+  * [Intercom](plugins/intercom.md)
+  * [Camera](plugins/camera.md)
+  * [Secure Storage](plugins/secure-storage.md)
+  * [Native Storage](plugins/native-storage.md)
+  * [App Preferences](plugins/app-preferences.md)
+  * [In App Review](plugins/in-app-review.md)
+  * [Flashlight](plugins/flashlight.md)
+  * [Facebook](plugins/facebook.md)
+  * [Wechat](plugins/wechat.md)
+  * [App Version](plugins/app-version.md)
+  * [Checkout](plugins/checkout.md)
+  * [Android Full Screen](plugins/android-full-screen.md)
+  * [Secure Storage Echo](plugins/secure-storage-echo.md)
+  * [Device Motion](plugins/device-motion.md)
+  * [IBeacon](plugins/ibeacon.md)
+  * [Keyboard](plugins/keyboard.md)
+  * [Deeplinks](plugins/deeplinks.md)
+  * [Firebase](plugins/firebase.md)
+  * [App Availability](plugins/app-availability.md)
+  * [Background Geolocation](plugins/background-geolocation.md)
+  * [Diagnostic](plugins/diagnostic.md)
+  * [Ionic Webview](plugins/ionic-webview.md)
+  * [Broadcaster](plugins/broadcaster.md)
+  * [Uptime](plugins/uptime.md)
+  * [Mixpanel](plugins/mixpanel.md)
+  * [Action Sheet](plugins/action-sheet.md)
+  * [HTTP](plugins/http.md)
+  * [OneSignal](plugins/onesignal.md)
+  * [Firebase Vision](plugins/firebase-vision.md)
+  * [Appsflyer](plugins/appsflyer.md)
+  * [Google Plus](plugins/google-plus.md)
+  * [Network](plugins/network.md)
+  * [SQLite Porter](plugins/sqlite-porter.md)
+  * [Touch ID](plugins/touch-id.md)
+  * [App Center Crashes](plugins/app-center-crashes.md)
+  * [ios-aswebauthenticationsession-api](plugins/ios-aswebauthenticationsession-api.md)
+  * [FCM](plugins/fcm.md)
+  * [RewardVideo](plugins/admob-plus.md)
+  * [CustomUISDK](plugins/custom-uisdk.md)
+  * [Foreground Service](plugins/foreground-service.md)
+  * [Sign In With Apple](plugins/sign-in-with-apple.md)
+  * [Location Accuracy](plugins/location-accuracy.md)
+  * [Barcode Scanner](plugins/barcode-scanner.md)
+  * [App Center Shared](plugins/app-center-shared.md)
+  * [BranchIo](plugins/branch-io.md)
+  * [PushapePush](plugins/pushape-push.md)
+  * [TealiumInstallReferrer](plugins/tealium-installreferrer.md)
+  * [Zeroconf](plugins/zeroconf.md)
+  * [Purchases](plugins/purchases.md)
+  * [Instagram](plugins/instagram.md)
+  * [Splash Screen](plugins/splash-screen.md)
+  * [Launch Review](plugins/launch-review.md)
+  * [Speech Recognition](plugins/speech-recognition.md)
+  * [Document Scanner](plugins/document-scanner.md)
+  * [Apple Wallet](plugins/apple-wallet.md)
+  * [SQLite](plugins/sqlite.md)
+  * [App Rate](plugins/app-rate.md)
+  * [Vibration](plugins/vibration.md)
+  * [Build Info](plugins/build-info.md)
+  * [Photo Viewer](plugins/photo-viewer.md)
+  * [Google Nearby](plugins/google-nearby.md)
+  * [Stripe](plugins/stripe.md)
+  * [Analytics Firebase](plugins/analytics-firebase.md)
+  * [AES256](plugins/aes-256.md)
+  * [Screen Orientation](plugins/screen-orientation.md)
+  * [Webengage](plugins/webengage.md)
+  * [AdjustAppStoreSubscription](plugins/adjust.md)
+  * [Line Login](plugins/line-login.md)
+  * [Is Debug](plugins/is-debug.md)
+  * [Clipboard](plugins/clipboard.md)
+  * [File Path](plugins/file-path.md)
+  * [Native Page Transitions](plugins/native-page-transitions.md)
+  * [WheelSelector Plugin](plugins/wheel-selector.md)
+  * [Email Composer](plugins/email-composer.md)
+  * [BlinkId](plugins/blinkid.md)
+  * [Call Number](plugins/call-number.md)
+  * [Battery Status](plugins/battery-status.md)
+  * [Firebase X](plugins/firebase-x.md)
+  * [Google Analytics](plugins/google-analytics.md)
+  * [ServiceDiscovery](plugins/service-discovery.md)
+  * [PDFGenerator](plugins/pdf-generator.md)
+  * [MLKitTranslate](plugins/mlkit-translate.md)
+  * [Usabilla](plugins/usabilla-cordova-sdk.md)
+  * [BioCatch](plugins/biocatch.md)
+  * [Bluetooth Serial](plugins/bluetooth-serial.md)
+  * [Video Player](plugins/video-player.md)
+  * [Streaming Media](plugins/streaming-media.md)
+  * [Firebase Crashlytics](plugins/firebase-crashlytics.md)
+  * [Zoom](plugins/zoom.md)
+  * [SMS](plugins/sms.md)
+  * [Imap](plugins/imap.md)
+  * [Ge Tui Sdk Plugin](plugins/ge-tui-sdk-plugin.md)
+  * [TealiumAdIdentifier](plugins/tealium-adidentifier.md)
+  * [UrbanAirShip](plugins/urbanairship.md)
+  * [In App Browser](plugins/in-app-browser.md)
+  * [In App Purchase 2](plugins/in-app-purchase-2.md)
+  * [Code Push](plugins/code-push.md)
+  * [Android Notch](plugins/android-notch.md)
+  * [Network Interface](plugins/network-interface.md)
+  * [Printer](plugins/printer.md)
+  * [Browser Tab](plugins/browser-tab.md)
+  * [Dynamsoft Barcode Scanner](plugins/dynamsoft-barcode-scanner.md)
+* [Installation](installation.md)
+* [FAQ](faq.md)
+

docs/faq.md

@@ -0,0 +1,87 @@
+# FAQ
+
+### [Cordova Management Tips](https://ionicframework.com/docs/native/community#cordova-management-tips) <a id="cordova-management-tips"></a>
+
+**1\) Use the** [**Ionic CLI**](https://ionicframework.com/docs/cli) **to add/update/delete plugins.**
+
+Instead of directly editing `config.xml` and `package.json`. Use `ionic` in front of Cordova commands for a better experience and additional functionality \(`ionic cordova build ios` instead of `cordova build ios`\).
+
+**2\) Upgrade plugins by removing, then re-adding them.**
+
+```text
+$ ionic cordova plugin remove cordova-plugin-camera
+$ ionic cordova plugin add cordova-plugin-camera
+```
+
+**3\) Install explicit versions.**
+
+To ensure that the same version of a plugin is always installed via `npm install`, specify the version number:
+
+```text
+$ ionic cordova plugin add cordova-plugin-camera@4.3.2
+```
+
+**4\) Restore Cordova in an existing Ionic project**
+
+Useful when adding new developers to a project. `ionic cordova prepare` restores platforms and plugins from `package.json` and `config.xml`. The version to be installed is taken from `package.json` or `config.xml`, if found in those files. In case of conflicts, `package.json` is given precedence over `config.xml`.
+
+**5\) Troubleshoot Cordova issues with Ionic CLI commands**
+
+* `ionic doctor list`: Detects [common issues](https://ionicframework.com/docs/cli/commands/doctor-list) and suggests steps to fix them
+* `ionic repair`: Remove, then [regenerate](https://ionicframework.com/docs/cli/commands/repair) all dependencies
+
+### [Understanding Version Numbers](https://ionicframework.com/docs/native/community#understanding-version-numbers) <a id="understanding-version-numbers"></a>
+
+For any given Ionic Native plugin, the Ionic Native \(TypeScript code\) and Cordova \(native code\) version numbers will not match. The Ionic Native version number is found in `package.json`:
+
+```text
+"@ionic-native/camera": "^5.3.0",
+```
+
+CopyCopied
+
+The Cordova plugin version number is found in both `package.json` and `config.xml`:
+
+```text
+"cordova-plugin-camera": "4.0.3",
+```
+
+CopyCopied
+
+```text
+<plugin name="cordova-plugin-camera" spec="4.0.3" />
+```
+
+CopyCopied
+
+When checking for new native functionality or bug fixes, look for new versions on the Cordova plugin GitHub page itself \(here's the [Camera one](https://github.com/apache/cordova-plugin-camera), for example\).
+
+To check for new Ionic Native releases \(may include exposing methods recently added by the Cordova plugin, etc.\), see [here](https://github.com/ionic-team/ionic-native/releases).
+
+### [Troubleshooting Failed Builds](https://ionicframework.com/docs/native/community#troubleshooting-failed-builds) <a id="troubleshooting-failed-builds"></a>
+
+Research the build error\(s\) by checking out these resources:
+
+* Google & [StackOverflow](https://stackoverflow.com/): Many issues are documented online
+* Ask the [Ionic Community Ionic Forum](https://forum.ionicframework.com/) \(see the Ionic Native category\)
+* See the Ionic Customer Success [Knowledge Base](https://ionic.zendesk.com/)
+
+#### [Cordova Plugin Conflicts](https://ionicframework.com/docs/native/community#cordova-plugin-conflicts) <a id="cordova-plugin-conflicts"></a>
+
+Plugins can conflict with each other when they share the same underlying native dependencies or when more than one plugin tries to access the same native code at once. For example, common libraries like the Google Play Services version \(Google Maps is using GPS v24.2 but Firebase wants GPS v27.1\). Keeping these plugins updated regularly can help with this.
+
+Another tip is to ensure that your app uses only one plugin per specific feature/functionality \(example: Push Notifications\).
+
+### [Recommended Upgrade Strategy](https://ionicframework.com/docs/native/community#recommended-upgrade-strategy) <a id="recommended-upgrade-strategy"></a>
+
+The most Ionic stable apps are routinely updated, especially at the native layer. Keeping native plugins up to date ensures your project has the latest security fixes, new features, and improved performance.
+
+Update your project's plugins one at a time, ideally in separate code branches. This reduces the surface area that issues can arise from - if you update everything in your project at once, it's sometimes hard to tell where the problem stems from.
+
+#### [When should I update?](https://ionicframework.com/docs/native/community#when-should-i-update-) <a id="when-should-i-update-"></a>
+
+* When a new feature/bug is released: Run `npm outdated` to see a list of available updates.
+* When new major versions are released: Official blogs, such as the [Cordova blog](https://cordova.apache.org/blog/)and [Ionic blog](https://ionicframework.com/blog/), will publish announcements and news.
+* Evaluate the nature of the update: is it a shiny new feature or critical security fix?
+* Timing: Where does it fit in against your team's project goals?
+

docs/installation.md

@@ -0,0 +1,144 @@
+# Installation
+
+[Apache Cordova](https://cordova.apache.org/) is an open source native runtime that allows developers to build native mobile apps with HTML, CSS, and JavaScript. Similar to [Capacitor](https://capacitorjs.com/), Ionic’s own native runtime, Cordova allows developers to access native device features, such as camera, keyboard, and geolocation, using a system of plugins. A plugin is a small amount of add-on code that provides JavaScript interface to native components. They allow your app to use native device capabilities beyond what is available to pure web apps.
+
+For developers using Ionic with Cordova, our team has developed a collection of TypeScript wrappers for open source Cordova plugins that make it easy to add native functionality to any Ionic app. See [Ionic Native](https://github.com/ionic-team/ionic-native).
+
+These plugins are submitted and maintained by the Ionic community. While community members are generally quick to find and fix issues, certain plugins may not function properly.
+
+For professional developers and teams that require dedicated native plugin support & SLAs, ongoing maintenance, and security patches, please explore our [premium options](https://ionicframework.com/native), including plugin support and pre-built solutions for common native use cases.
+
+> These docs are for apps built with Ionic Framework 4.0.0 and greater. For older Ionic v3 projects, please [see here](https://ionicframework.com/docs/v3/native).
+
+### [Capacitor Support](https://ionicframework.com/docs/native/community#capacitor-support) <a id="capacitor-support"></a>
+
+In addition to Cordova, Ionic Native also works with [Capacitor](https://capacitor.ionicframework.com/), Ionic's official native runtime. Basic usage below. For complete details, [see the Capacitor documentation](https://capacitor.ionicframework.com/docs/cordova/using-cordova-plugins).
+
+### [Usage](https://ionicframework.com/docs/native/community#usage) <a id="usage"></a>
+
+All plugins have two components - the native code \(Cordova\) and the TypeScript code \(Ionic Native\). Cordova plugins are also wrapped in a `Promise` or `Observable` in order to provide a common plugin interface and modernized development approach.
+
+Using the [Camera plugin](https://ionicframework.com/docs/native/camera) as an example, first install it:CORDOVACAPACITOR
+
+```text
+// Install Cordova plugin
+$ ionic cordova plugin add cordova-plugin-camera
+
+// Install Ionic Native TypeScript wrapper
+$ npm install @ionic-native/camera
+
+// Install Ionic Native core library (once per project)
+$ npm install @ionic-native/core
+```
+
+Next, begin using the plugin, following the various framework usage options below. For FAQ, see [here](https://ionicframework.com/docs/native/faq).
+
+### [Angular](https://ionicframework.com/docs/native/community#angular) <a id="angular"></a>
+
+Angular apps can use either Cordova or Capacitor to build native mobile apps. Import the plugin in a `@NgModule` and add it to the list of Providers. For Angular, the import path should end with `/ngx`. Angular's change detection is automatically handled.
+
+```text
+// app.module.ts
+import { Camera } from '@ionic-native/camera/ngx';
+
+...
+
+@NgModule({
+  ...
+
+  providers: [
+    ...
+    Camera
+    ...
+  ]
+  ...
+})
+export class AppModule { }
+```
+
+CopyCopied
+
+After the plugin has been declared, it can be imported and injected like any other service:
+
+```text
+// camera.service.ts
+import { Injectable } from "@angular/core";
+import { Camera, CameraOptions } from "@ionic-native/camera/ngx";
+
+@Injectable({
+  providedIn: "root",
+})
+export class PhotoService {
+  constructor(private camera: Camera) {}
+
+  takePicture() {
+    const options: CameraOptions = {
+      quality: 100,
+      destinationType: this.camera.DestinationType.DATA_URL,
+      encodingType: this.camera.EncodingType.JPEG,
+      mediaType: this.camera.MediaType.PICTURE,
+    };
+
+    this.camera.getPicture(options).then(
+      (imageData) => {
+        // Do something with the new photo
+      },
+      (err) => {
+        // Handle error
+        console.log("Camera issue: " + err);
+      }
+    );
+  }
+}
+```
+
+CopyCopied
+
+### [React](https://ionicframework.com/docs/native/community#react) <a id="react"></a>
+
+React apps must use Capacitor to build native mobile apps. However, Ionic Native \(and therefore, Cordova plugins\) can still be used.// Install Core library \(once per project\)npm install @ionic-native/core  
+// Install Ionic Native TypeScript wrappernpm install @ionic-native/barcode-scanner  
+// Install Cordova pluginnpm install phonegap-plugin-barcodescanner  
+// Update native platform project\(s\) to include newly added pluginionic cap sync
+
+Import the plugin object then use its static methods:
+
+```text
+import { BarcodeScanner } from "@ionic-native/barcode-scanner";
+
+const Tab1: React.FC = () => {
+  const openScanner = async () => {
+    const data = await BarcodeScanner.scan();
+    console.log(`Barcode data: ${data.text}`);
+  };
+  return (
+    <IonPage>
+      <IonHeader>
+        <IonToolbar>
+          <IonTitle>Tab 1</IonTitle>
+        </IonToolbar>
+      </IonHeader>
+      <IonContent>
+        <IonButton onClick={openScanner}>Scan barcode</IonButton>
+      </IonContent>
+    </IonPage>
+  );
+};
+```
+
+CopyCopied
+
+### [Vanilla JavaScript](https://ionicframework.com/docs/native/community#vanilla-javascript) <a id="vanilla-javascript"></a>
+
+Vanilla JavaScript apps, targeting ES2015+ and/or TypeScript, can use either Cordova or Capacitor to build native mobile apps. To use any plugin, import the class from the appropriate package and use its static methods:
+
+```text
+import { Camera } from "@ionic-native/camera";
+
+document.addEventListener("deviceready", () => {
+  Camera.getPicture()
+    .then((data) => console.log("Took a picture!", data))
+    .catch((e) => console.log("Error occurred while taking a picture", e));
+});
+```
+

docs/plugins/README.md

@@ -0,0 +1,20 @@
+# Plugins
+
+## 15.0.0 - 2042-12-03
+
+### Fixed
+
+* Removed humans, they weren't doing fine with animals.
+
+### Changed
+
+* Animals are now super cute, all of them.
+
+## 14.0.0 - 2042-10-06
+
+### Added
+
+* Introduced animals into the world, we believe they're going to be a neat addition.
+
+
+

docs/plugins/abbyy-rtr.md

@@ -0,0 +1,18 @@
+# ABBYY Real-Time Recognition
+
+```text
+$ ionic cordova plugin add cordova-plugin-abbyy-rtr-sdk
+$ npm install @awesome-cordova-plugins/abbyy-rtr
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/abbyy-rtr/)
+
+Plugin Repo: [https://github.com/abbyysdk/RTR-SDK.Cordova](https://github.com/abbyysdk/RTR-SDK.Cordova)
+
+This plugin allows to use the Text Capture and Data Capture features of ABBYY Real-Time Recognition SDK \(RTR SDK\) in apps.
+
+## Supported platforms
+
+* Android
+  * iOS
+

docs/plugins/abbyy-rtr/README.md

@@ -0,0 +1,21 @@
+# ABBYY Real-Time Recognition
+
+```
+$ ionic cordova plugin add cordova-plugin-abbyy-rtr-sdk
+$ npm install @awesome-cordova-plugins/abbyy-rtr
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/abbyy-rtr/)
+
+Plugin Repo: [https://github.com/abbyysdk/RTR-SDK.Cordova](https://github.com/abbyysdk/RTR-SDK.Cordova)
+
+This plugin allows to use the Text Capture and Data Capture features of
+ABBYY Real-Time Recognition SDK (RTR SDK) in apps.
+
+## Supported platforms
+
+- Android
+  - iOS
+  
+
+

docs/plugins/action-sheet.md

@@ -0,0 +1,23 @@
+# Action Sheet
+
+```text
+$ ionic cordova plugin add cordova-plugin-actionsheet
+$ npm install @awesome-cordova-plugins/action-sheet
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/action-sheet/)
+
+Plugin Repo: [https://github.com/EddyVerbruggen/cordova-plugin-actionsheet](https://github.com/EddyVerbruggen/cordova-plugin-actionsheet)
+
+The ActionSheet plugin shows a native list of options the user can choose from.
+
+Requires Cordova plugin: `cordova-plugin-actionsheet`. For more info, please see the [ActionSheet plugin docs](https://github.com/EddyVerbruggen/cordova-plugin-actionsheet).
+
+## Supported platforms
+
+* Android
+  * Browser
+  * iOS
+  * Windows
+  * Windows Phone 8
+

docs/plugins/action-sheet/README.md

@@ -0,0 +1,25 @@
+# Action Sheet
+
+```
+$ ionic cordova plugin add cordova-plugin-actionsheet
+$ npm install @awesome-cordova-plugins/action-sheet
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/action-sheet/)
+
+Plugin Repo: [https://github.com/EddyVerbruggen/cordova-plugin-actionsheet](https://github.com/EddyVerbruggen/cordova-plugin-actionsheet)
+
+The ActionSheet plugin shows a native list of options the user can choose from.
+
+Requires Cordova plugin: `cordova-plugin-actionsheet`. For more info, please see the [ActionSheet plugin docs](https://github.com/EddyVerbruggen/cordova-plugin-actionsheet).
+
+## Supported platforms
+
+- Android
+  - Browser
+  - iOS
+  - Windows
+  - Windows Phone 8
+  
+
+

docs/plugins/adjust.md

@@ -0,0 +1,19 @@
+# AdjustAppStoreSubscription
+
+plugin add com.adjust.sdk $ npm install @awesome-cordova-plugins/adjust
+
+\`\`\`
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/adjust/)
+
+Plugin Repo: [https://github.com/adjust/cordova\_sdk](https://github.com/adjust/cordova_sdk)
+
+This is the Ionic Cordova SDK of Adjust™. You can read more about Adjust™ at adjust.com.
+
+Requires Cordova plugin: `com.adjust.sdk`. For more info, please see the [Adjust Cordova SDK](https://github.com/adjust/cordova_sdk)
+
+## Supported platforms
+
+* Android
+  * iOS
+

docs/plugins/adjust/README.md

@@ -0,0 +1,22 @@
+# Adjust
+
+```
+$ ionic cordova plugin add com.adjust.sdk
+$ npm install @awesome-cordova-plugins/adjust
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/adjust/)
+
+Plugin Repo: [https://github.com/adjust/cordova_sdk](https://github.com/adjust/cordova_sdk)
+
+This is the Ionic Cordova SDK of Adjust™. You can read more about Adjust™ at adjust.com.
+
+Requires Cordova plugin: `com.adjust.sdk`. For more info, please see the [Adjust Cordova SDK](https://github.com/adjust/cordova_sdk)
+
+## Supported platforms
+
+- Android
+  - iOS
+  
+
+

docs/plugins/admob-plus.md

@@ -0,0 +1,25 @@
+# RewardVideo
+
+```text
+$ ionic cordova plugin add cordova-admob-plus
+$ npm install @awesome-cordova-plugins/admob-plus
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/admob-plus/)
+
+Plugin Repo: 
+
+b.com/admob-plus/admob-plus\]\([https://github.com/admob-plus/admob-plus](https://github.com/admob-plus/admob-plus)\)
+
+## Supported platforms
+
+* Android
+  * iOS
+
+n-admob-free, which provides a cleaner API and build with modern tools.
+
+## Supported platforms
+
+* Android
+  * iOS
+

docs/plugins/admob-plus/README.md

@@ -0,0 +1,29 @@
+# AdMob
+
+```
+$ ionic cordova plugin add cordova-admob-plus
+$ npm install @awesome-cordova-plugins/admob-plus
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/admob-plus/)
+
+Plugin Repo: [https://github.com/admob-plus/admob-plus](https://github.com/admob-plus/admob-plus)
+
+
+
+## Supported platforms
+
+- Android
+  - iOS
+  
+
+
+n-admob-free, which provides a cleaner API and build with modern tools.
+
+## Supported platforms
+
+- Android
+  - iOS
+  
+
+

docs/plugins/admob-pro.md

@@ -0,0 +1,21 @@
+# AdMob Pro
+
+```text
+$ ionic cordova plugin add cordova-plugin-admobpro
+$ npm install @awesome-cordova-plugins/admob-pro
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/admob-pro/)
+
+Plugin Repo: [https://github.com/floatinghotpot/cordova-admob-pro](https://github.com/floatinghotpot/cordova-admob-pro)
+
+Plugin for Google Ads, including AdMob / DFP \(DoubleClick for publisher\) and mediations to other Ad networks.
+
+IMPORTANT NOTICE: this plugin takes a percentage out of your earnings if you profit more than $1,000. Read more about this on the plugin's repo. For a completely free alternative, see [AdMobPro Free](https://github.com/danielsogl/awesome-cordova-plugins/tree/8516b357edaca8fc543713ba99c42cfde0225f86/docs/plugins/admob-free/README.md).
+
+## Supported platforms
+
+* Android
+  * iOS
+  * Windows Phone 8
+

docs/plugins/admob-pro/README.md

@@ -0,0 +1,23 @@
+# AdMob Pro
+
+```
+$ ionic cordova plugin add cordova-plugin-admobpro
+$ npm install @awesome-cordova-plugins/admob-pro
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/admob-pro/)
+
+Plugin Repo: [https://github.com/floatinghotpot/cordova-admob-pro](https://github.com/floatinghotpot/cordova-admob-pro)
+
+Plugin for Google Ads, including AdMob / DFP (DoubleClick for publisher) and mediations to other Ad networks.
+
+IMPORTANT NOTICE: this plugin takes a percentage out of your earnings if you profit more than $1,000. Read more about this on the plugin's repo. For a completely free alternative, see [AdMobPro Free](../admob-free).
+
+## Supported platforms
+
+- Android
+  - iOS
+  - Windows Phone 8
+  
+
+

docs/plugins/admob.md

@@ -0,0 +1,26 @@
+# AdMob
+
+```text
+$ ionic cordova plugin add cordova-admob
+$ npm install @awesome-cordova-plugins/admob
+```
+
+## [Usage Documentation](https://danielsogl.gitbook.io/awesome-cordova-plugins/plugins/admob/)
+
+Plugin Repo: [https://github.com/appfeel/admob-google-cordova](https://github.com/appfeel/admob-google-cordova)
+
+Most complete Admob plugin with support for [Tappx](http://www.tappx.com/?h=dec334d63287772de859bdb4e977fce6) ads. Monetize your apps and games with AdMob ads, using latest Google AdMob SDK. With this plugin you can show AdMob ads easily!
+
+Supports:\*\*
+
+* Banner ads \(top and bottom\)
+* Interstitial ads
+* Rewarded ads
+* [Tappx](http://www.tappx.com/?h=dec334d63287772de859bdb4e977fce6) ads
+
+## Supported platforms
+
+* Android
+  * iOS
+  * Browser
+