@capawesome/capacitor-shake 0.0.1

package/CapawesomeCapacitorShake.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorShake'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+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.

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorShake",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorShake",
+            targets: ["ShakePlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "ShakePlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "ShakePluginTests",
+            dependencies: ["ShakePlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,204 @@
+# @capawesome/capacitor-shake
+
+Capacitor plugin to detect shake gestures.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+- 📳 **Shake detection**: Detect physical shake gestures on the device.
+- 🎚️ **Sensitivity**: Configure how strong a shake must be to trigger an event.
+- 🔋 **Battery-friendly**: The sensor is only active while you are watching for shakes.
+- 📱 **Cross-platform**: One consistent API for Android and iOS.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-shake` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following command:
+
+```bash
+npm install @capawesome/capacitor-shake
+npx cap sync
+```
+
+This plugin is available on **Android** and **iOS**. On Web, all methods reject as unimplemented.
+
+No additional permissions or privacy descriptions are required.
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { Shake } from '@capawesome/capacitor-shake';
+
+const startWatching = async () => {
+  await Shake.addListener('shake', () => {
+    console.log('Shake detected!');
+  });
+  await Shake.startWatching({ sensitivity: 'medium' });
+};
+
+const stopWatching = async () => {
+  await Shake.stopWatching();
+  await Shake.removeAllListeners();
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`addListener('shake', ...)`](#addlistenershake-)
+* [`removeAllListeners()`](#removealllisteners)
+* [`startWatching(...)`](#startwatching)
+* [`stopWatching()`](#stopwatching)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### addListener('shake', ...)
+
+```typescript
+addListener(eventName: 'shake', listenerFunc: () => void) => Promise<PluginListenerHandle>
+```
+
+Called when a shake gesture is detected.
+
+Only available on Android and iOS.
+
+| Param              | Type                       |
+| ------------------ | -------------------------- |
+| **`eventName`**    | <code>'shake'</code>       |
+| **`listenerFunc`** | <code>() =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### removeAllListeners()
+
+```typescript
+removeAllListeners() => Promise<void>
+```
+
+Remove all listeners for this plugin.
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### startWatching(...)
+
+```typescript
+startWatching(options?: StartWatchingOptions | undefined) => Promise<void>
+```
+
+Start watching for shake gestures.
+
+Only available on Android and iOS.
+
+| Param         | Type                                                                  |
+| ------------- | --------------------------------------------------------------------- |
+| **`options`** | <code><a href="#startwatchingoptions">StartWatchingOptions</a></code> |
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### stopWatching()
+
+```typescript
+stopWatching() => Promise<void>
+```
+
+Stop watching for shake gestures.
+
+Only available on Android and iOS.
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+#### StartWatchingOptions
+
+| Prop              | Type                                                | Description                                                                                                                                                 | Default               | Since |
+| ----------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----- |
+| **`sensitivity`** | <code><a href="#sensitivity">Sensitivity</a></code> | The sensitivity of the shake detection. Use `'light'` to detect gentle shakes and `'hard'` to only detect strong shakes. Only available on Android and iOS. | <code>'medium'</code> | 0.1.0 |
+
+
+### Type Aliases
+
+
+#### Sensitivity
+
+<code>'hard' | 'light' | 'medium'</code>
+
+</docgen-api>
+
+## Sensitivity Levels
+
+The `sensitivity` option controls how strong a shake must be to emit a `shake` event:
+
+- `light`: A gentle shake is enough to trigger an event.
+- `medium`: A moderate shake is required to trigger an event (default).
+- `hard`: Only a strong shake triggers an event.
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/shake/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/shake/LICENSE).

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.shake"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/Shake.java

@@ -0,0 +1,80 @@
+package io.capawesome.capacitorjs.plugins.shake;
+
+import android.content.Context;
+import android.hardware.Sensor;
+import android.hardware.SensorEvent;
+import android.hardware.SensorEventListener;
+import android.hardware.SensorManager;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import io.capawesome.capacitorjs.plugins.shake.classes.interfaces.EmptyCallback;
+import io.capawesome.capacitorjs.plugins.shake.classes.options.StartWatchingOptions;
+
+public class Shake implements SensorEventListener {
+
+    @NonNull
+    private final ShakePlugin plugin;
+
+    @Nullable
+    private final Sensor accelerometerSensor;
+
+    private long lastShakeTimestamp = 0;
+
+    @NonNull
+    private final SensorManager sensorManager;
+
+    private static final long SHAKE_DEBOUNCE_IN_MILLISECONDS = 500;
+
+    private float shakeThreshold = 0;
+
+    private boolean watching = false;
+
+    public Shake(@NonNull ShakePlugin plugin) {
+        this.plugin = plugin;
+        this.sensorManager = (SensorManager) plugin.getContext().getSystemService(Context.SENSOR_SERVICE);
+        this.accelerometerSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
+    }
+
+    public boolean isAvailable() {
+        return accelerometerSensor != null;
+    }
+
+    @Override
+    public void onAccuracyChanged(Sensor sensor, int accuracy) {}
+
+    @Override
+    public void onSensorChanged(SensorEvent event) {
+        double gX = event.values[0] / SensorManager.GRAVITY_EARTH;
+        double gY = event.values[1] / SensorManager.GRAVITY_EARTH;
+        double gZ = event.values[2] / SensorManager.GRAVITY_EARTH;
+        double gForce = Math.sqrt(gX * gX + gY * gY + gZ * gZ);
+        if (gForce < shakeThreshold) {
+            return;
+        }
+        long now = System.currentTimeMillis();
+        if (now - lastShakeTimestamp < SHAKE_DEBOUNCE_IN_MILLISECONDS) {
+            return;
+        }
+        lastShakeTimestamp = now;
+        plugin.notifyShakeListeners();
+    }
+
+    public void startWatching(@NonNull StartWatchingOptions options, @NonNull EmptyCallback callback) {
+        shakeThreshold = options.getShakeThreshold();
+        if (!watching) {
+            sensorManager.registerListener(this, accelerometerSensor, SensorManager.SENSOR_DELAY_GAME);
+            watching = true;
+        }
+        callback.success();
+    }
+
+    public void stopWatching(@Nullable EmptyCallback callback) {
+        if (watching) {
+            sensorManager.unregisterListener(this);
+            watching = false;
+        }
+        if (callback != null) {
+            callback.success();
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/ShakePlugin.java

@@ -0,0 +1,97 @@
+package io.capawesome.capacitorjs.plugins.shake;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Logger;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import io.capawesome.capacitorjs.plugins.shake.classes.interfaces.EmptyCallback;
+import io.capawesome.capacitorjs.plugins.shake.classes.options.StartWatchingOptions;
+
+@CapacitorPlugin(name = "Shake")
+public class ShakePlugin extends Plugin {
+
+    public static final String ERROR_UNKNOWN_ERROR = "An unknown error occurred.";
+    public static final String EVENT_SHAKE = "shake";
+    public static final String TAG = "ShakePlugin";
+
+    private Shake implementation;
+
+    @Override
+    public void load() {
+        implementation = new Shake(this);
+    }
+
+    public void notifyShakeListeners() {
+        notifyListeners(EVENT_SHAKE, new JSObject());
+    }
+
+    @PluginMethod
+    public void startWatching(PluginCall call) {
+        try {
+            StartWatchingOptions options = new StartWatchingOptions(call);
+            if (!implementation.isAvailable()) {
+                rejectCallAsUnavailable(call);
+                return;
+            }
+            EmptyCallback callback = new EmptyCallback() {
+                @Override
+                public void success() {
+                    resolveCall(call);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.startWatching(options, callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @PluginMethod
+    public void stopWatching(PluginCall call) {
+        try {
+            EmptyCallback callback = new EmptyCallback() {
+                @Override
+                public void success() {
+                    resolveCall(call);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.stopWatching(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @Override
+    protected void handleOnDestroy() {
+        implementation.stopWatching(null);
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message);
+    }
+
+    private void rejectCallAsUnavailable(@NonNull PluginCall call) {
+        call.unavailable("This method is not available on this platform.");
+    }
+
+    private void resolveCall(@NonNull PluginCall call) {
+        call.resolve();
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/classes/CustomException.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.shake.classes;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+public class CustomException extends Exception {
+
+    @Nullable
+    private final String code;
+
+    public CustomException(@Nullable String code, @NonNull String message) {
+        super(message);
+        this.code = code;
+    }
+
+    @Nullable
+    public String getCode() {
+        return code;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/classes/CustomExceptions.java

@@ -0,0 +1,9 @@
+package io.capawesome.capacitorjs.plugins.shake.classes;
+
+public class CustomExceptions {
+
+    public static final CustomException INVALID_SENSITIVITY = new CustomException(
+        null,
+        "sensitivity must be one of 'light', 'medium' or 'hard'."
+    );
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/classes/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.shake.classes.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/classes/interfaces/EmptyCallback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.shake.classes.interfaces;
+
+public interface EmptyCallback extends Callback {
+    void success();
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/shake/classes/options/StartWatchingOptions.java

@@ -0,0 +1,40 @@
+package io.capawesome.capacitorjs.plugins.shake.classes.options;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.PluginCall;
+import io.capawesome.capacitorjs.plugins.shake.classes.CustomExceptions;
+
+public class StartWatchingOptions {
+
+    public static final String SENSITIVITY_HARD = "hard";
+    public static final String SENSITIVITY_LIGHT = "light";
+    public static final String SENSITIVITY_MEDIUM = "medium";
+
+    private static final float SHAKE_THRESHOLD_HARD = 3.4f;
+    private static final float SHAKE_THRESHOLD_LIGHT = 2.3f;
+    private static final float SHAKE_THRESHOLD_MEDIUM = 2.7f;
+
+    private final float shakeThreshold;
+
+    public StartWatchingOptions(@NonNull PluginCall call) throws Exception {
+        String sensitivity = call.getString("sensitivity", SENSITIVITY_MEDIUM);
+        this.shakeThreshold = StartWatchingOptions.getShakeThresholdForSensitivity(sensitivity);
+    }
+
+    public float getShakeThreshold() {
+        return shakeThreshold;
+    }
+
+    private static float getShakeThresholdForSensitivity(@NonNull String sensitivity) throws Exception {
+        switch (sensitivity) {
+            case SENSITIVITY_HARD:
+                return SHAKE_THRESHOLD_HARD;
+            case SENSITIVITY_LIGHT:
+                return SHAKE_THRESHOLD_LIGHT;
+            case SENSITIVITY_MEDIUM:
+                return SHAKE_THRESHOLD_MEDIUM;
+            default:
+                throw CustomExceptions.INVALID_SENSITIVITY;
+        }
+    }
+}

package/dist/docs.json

@@ -0,0 +1,174 @@
+{
+  "api": {
+    "name": "ShakePlugin",
+    "slug": "shakeplugin",
+    "docs": "",
+    "tags": [
+      {
+        "text": "0.1.0",
+        "name": "since"
+      }
+    ],
+    "methods": [
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'shake', listenerFunc: () => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'shake'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "() => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Called when a shake gesture is detected.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "PluginListenerHandle"
+        ],
+        "slug": "addlistenershake-"
+      },
+      {
+        "name": "removeAllListeners",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Remove all listeners for this plugin.",
+        "complexTypes": [],
+        "slug": "removealllisteners"
+      },
+      {
+        "name": "startWatching",
+        "signature": "(options?: StartWatchingOptions | undefined) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "StartWatchingOptions | undefined"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Start watching for shake gestures.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "StartWatchingOptions"
+        ],
+        "slug": "startwatching"
+      },
+      {
+        "name": "stopWatching",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Stop watching for shake gestures.\n\nOnly available on Android and iOS.",
+        "complexTypes": [],
+        "slug": "stopwatching"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
+    },
+    {
+      "name": "StartWatchingOptions",
+      "slug": "startwatchingoptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "sensitivity",
+          "tags": [
+            {
+              "text": "0.1.0",
+              "name": "since"
+            },
+            {
+              "text": "'medium'",
+              "name": "default"
+            },
+            {
+              "text": "'medium'",
+              "name": "example"
+            }
+          ],
+          "docs": "The sensitivity of the shake detection.\n\nUse `'light'` to detect gentle shakes and `'hard'` to only detect strong shakes.\n\nOnly available on Android and iOS.",
+          "complexTypes": [
+            "Sensitivity"
+          ],
+          "type": "Sensitivity"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "Sensitivity",
+      "slug": "sensitivity",
+      "docs": "",
+      "types": [
+        {
+          "text": "'hard'",
+          "complexTypes": []
+        },
+        {
+          "text": "'light'",
+          "complexTypes": []
+        },
+        {
+          "text": "'medium'",
+          "complexTypes": []
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,57 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+/**
+ * @since 0.1.0
+ */
+export interface ShakePlugin {
+    /**
+     * Called when a shake gesture is detected.
+     *
+     * Only available on Android and iOS.
+     *
+     * @since 0.1.0
+     */
+    addListener(eventName: 'shake', listenerFunc: () => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     *
+     * @since 0.1.0
+     */
+    removeAllListeners(): Promise<void>;
+    /**
+     * Start watching for shake gestures.
+     *
+     * Only available on Android and iOS.
+     *
+     * @since 0.1.0
+     */
+    startWatching(options?: StartWatchingOptions): Promise<void>;
+    /**
+     * Stop watching for shake gestures.
+     *
+     * Only available on Android and iOS.
+     *
+     * @since 0.1.0
+     */
+    stopWatching(): Promise<void>;
+}
+/**
+ * @since 0.1.0
+ */
+export interface StartWatchingOptions {
+    /**
+     * The sensitivity of the shake detection.
+     *
+     * Use `'light'` to detect gentle shakes and `'hard'` to only detect strong shakes.
+     *
+     * Only available on Android and iOS.
+     *
+     * @since 0.1.0
+     * @default 'medium'
+     * @example 'medium'
+     */
+    sensitivity?: Sensitivity;
+}
+/**
+ * @since 0.1.0
+ */
+export type Sensitivity = 'hard' | 'light' | 'medium';

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * @since 0.1.0\n */\nexport interface ShakePlugin {\n  /**\n   * Called when a shake gesture is detected.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'shake',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 0.1.0\n   */\n  removeAllListeners(): Promise<void>;\n  /**\n   * Start watching for shake gestures.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  startWatching(options?: StartWatchingOptions): Promise<void>;\n  /**\n   * Stop watching for shake gestures.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  stopWatching(): Promise<void>;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface StartWatchingOptions {\n  /**\n   * The sensitivity of the shake detection.\n   *\n   * Use `'light'` to detect gentle shakes and `'hard'` to only detect strong shakes.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   * @default 'medium'\n   * @example 'medium'\n   */\n  sensitivity?: Sensitivity;\n}\n\n/**\n * @since 0.1.0\n */\nexport type Sensitivity = 'hard' | 'light' | 'medium';\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { ShakePlugin } from './definitions';
+declare const Shake: ShakePlugin;
+export * from './definitions';
+export { Shake };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const Shake = registerPlugin('Shake', {
+    web: () => import('./web').then(m => new m.ShakeWeb()),
+});
+export * from './definitions';
+export { Shake };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,KAAK,GAAG,cAAc,CAAc,OAAO,EAAE;IACjD,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;CACvD,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { ShakePlugin } from './definitions';\n\nconst Shake = registerPlugin<ShakePlugin>('Shake', {\n  web: () => import('./web').then(m => new m.ShakeWeb()),\n});\n\nexport * from './definitions';\nexport { Shake };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,6 @@
+import { WebPlugin } from '@capacitor/core';
+import type { ShakePlugin } from './definitions';
+export declare class ShakeWeb extends WebPlugin implements ShakePlugin {
+    startWatching(): Promise<void>;
+    stopWatching(): Promise<void>;
+}

package/dist/esm/web.js

@@ -0,0 +1,10 @@
+import { WebPlugin } from '@capacitor/core';
+export class ShakeWeb extends WebPlugin {
+    async startWatching() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async stopWatching() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,QAAS,SAAQ,SAAS;IACrC,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { ShakePlugin } from './definitions';\n\nexport class ShakeWeb extends WebPlugin implements ShakePlugin {\n  async startWatching(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async stopWatching(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,24 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const Shake = core.registerPlugin('Shake', {
+    web: () => Promise.resolve().then(function () { return web; }).then(m => new m.ShakeWeb()),
+});
+
+class ShakeWeb extends core.WebPlugin {
+    async startWatching() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+    async stopWatching() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    ShakeWeb: ShakeWeb
+});
+
+exports.Shake = Shake;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Shake = registerPlugin('Shake', {\n    web: () => import('./web').then(m => new m.ShakeWeb()),\n});\nexport * from './definitions';\nexport { Shake };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ShakeWeb extends WebPlugin {\n    async startWatching() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async stopWatching() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,KAAK,GAAGA,mBAAc,CAAC,OAAO,EAAE;AACtC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC1D,CAAC;;ACFM,MAAM,QAAQ,SAASC,cAAS,CAAC;AACxC,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,27 @@
+var capacitorShake = (function (exports, core) {
+    'use strict';
+
+    const Shake = core.registerPlugin('Shake', {
+        web: () => Promise.resolve().then(function () { return web; }).then(m => new m.ShakeWeb()),
+    });
+
+    class ShakeWeb extends core.WebPlugin {
+        async startWatching() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+        async stopWatching() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        ShakeWeb: ShakeWeb
+    });
+
+    exports.Shake = Shake;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Shake = registerPlugin('Shake', {\n    web: () => import('./web').then(m => new m.ShakeWeb()),\n});\nexport * from './definitions';\nexport { Shake };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ShakeWeb extends WebPlugin {\n    async startWatching() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async stopWatching() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,KAAK,GAAGA,mBAAc,CAAC,OAAO,EAAE;IACtC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;;ICFM,MAAM,QAAQ,SAASC,cAAS,CAAC;IACxC,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Plugin/Classes/Options/StartWatchingOptions.swift

@@ -0,0 +1,32 @@
+import Foundation
+import Capacitor
+
+@objc public class StartWatchingOptions: NSObject {
+    private static let sensitivityHard = "hard"
+    private static let sensitivityLight = "light"
+    private static let sensitivityMedium = "medium"
+
+    private static let shakeThresholdHard = 3.4
+    private static let shakeThresholdLight = 2.3
+    private static let shakeThresholdMedium = 2.7
+
+    let shakeThreshold: Double
+
+    init(_ call: CAPPluginCall) throws {
+        let sensitivity = call.getString("sensitivity", StartWatchingOptions.sensitivityMedium)
+        self.shakeThreshold = try StartWatchingOptions.shakeThreshold(for: sensitivity)
+    }
+
+    private static func shakeThreshold(for sensitivity: String) throws -> Double {
+        switch sensitivity {
+        case sensitivityHard:
+            return shakeThresholdHard
+        case sensitivityLight:
+            return shakeThresholdLight
+        case sensitivityMedium:
+            return shakeThresholdMedium
+        default:
+            throw CustomError.invalidSensitivity
+        }
+    }
+}

package/ios/Plugin/Enums/CustomError.swift

@@ -0,0 +1,21 @@
+import Foundation
+
+enum CustomError: Error {
+    case invalidSensitivity
+
+    var code: String? {
+        switch self {
+        case .invalidSensitivity:
+            return nil
+        }
+    }
+}
+
+extension CustomError: LocalizedError {
+    public var errorDescription: String? {
+        switch self {
+        case .invalidSensitivity:
+            return NSLocalizedString("sensitivity must be one of 'light', 'medium' or 'hard'.", comment: "invalidSensitivity")
+        }
+    }
+}

package/ios/Plugin/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

package/ios/Plugin/Shake.swift

@@ -0,0 +1,60 @@
+import Foundation
+import CoreMotion
+
+@objc public class Shake: NSObject {
+    private let plugin: ShakePlugin
+    private var lastShakeTimestamp: TimeInterval = 0
+    private lazy var motionManager = CMMotionManager()
+    private let queue = OperationQueue()
+    private let shakeDebounceInterval: TimeInterval = 0.5
+    private var shakeThreshold: Double = 0
+    private let updateInterval: TimeInterval = 0.1
+    private var watching = false
+
+    init(plugin: ShakePlugin) {
+        self.plugin = plugin
+    }
+
+    @objc public func isAvailable() -> Bool {
+        return motionManager.isAccelerometerAvailable
+    }
+
+    @objc public func startWatching(_ options: StartWatchingOptions, completion: @escaping (_ error: Error?) -> Void) {
+        shakeThreshold = options.shakeThreshold
+        if watching {
+            completion(nil)
+            return
+        }
+        motionManager.accelerometerUpdateInterval = updateInterval
+        motionManager.startAccelerometerUpdates(to: queue) { [weak self] data, _ in
+            guard let self = self, let data = data else {
+                return
+            }
+            self.handleAccelerometerData(data)
+        }
+        watching = true
+        completion(nil)
+    }
+
+    @objc public func stopWatching(completion: ((_ error: Error?) -> Void)? = nil) {
+        if watching {
+            motionManager.stopAccelerometerUpdates()
+            watching = false
+        }
+        completion?(nil)
+    }
+
+    private func handleAccelerometerData(_ data: CMAccelerometerData) {
+        let acceleration = data.acceleration
+        let gForce = (acceleration.x * acceleration.x + acceleration.y * acceleration.y + acceleration.z * acceleration.z).squareRoot()
+        if gForce < shakeThreshold {
+            return
+        }
+        let now = Date().timeIntervalSince1970
+        if now - lastShakeTimestamp < shakeDebounceInterval {
+            return
+        }
+        lastShakeTimestamp = now
+        plugin.notifyShakeListeners()
+    }
+}

package/ios/Plugin/ShakePlugin.swift

@@ -0,0 +1,67 @@
+import Foundation
+import Capacitor
+
+@objc(ShakePlugin)
+public class ShakePlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "ShakePlugin"
+    public let jsName = "Shake"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "startWatching", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "stopWatching", returnType: CAPPluginReturnPromise)
+    ]
+
+    public static let shakeEvent = "shake"
+    public static let tag = "ShakePlugin"
+
+    private var implementation: Shake?
+
+    override public func load() {
+        self.implementation = Shake(plugin: self)
+    }
+
+    @objc public func notifyShakeListeners() {
+        notifyListeners(Self.shakeEvent, data: nil)
+    }
+
+    @objc func startWatching(_ call: CAPPluginCall) {
+        do {
+            let options = try StartWatchingOptions(call)
+            guard implementation?.isAvailable() == true else {
+                rejectCallAsUnavailable(call)
+                return
+            }
+            implementation?.startWatching(options) { error in
+                if let error = error {
+                    self.rejectCall(call, error)
+                    return
+                }
+                self.resolveCall(call)
+            }
+        } catch {
+            rejectCall(call, error)
+        }
+    }
+
+    @objc func stopWatching(_ call: CAPPluginCall) {
+        implementation?.stopWatching { error in
+            if let error = error {
+                self.rejectCall(call, error)
+                return
+            }
+            self.resolveCall(call)
+        }
+    }
+
+    private func rejectCall(_ call: CAPPluginCall, _ error: Error) {
+        CAPLog.print("[", ShakePlugin.tag, "] ", error)
+        call.reject(error.localizedDescription)
+    }
+
+    private func rejectCallAsUnavailable(_ call: CAPPluginCall) {
+        call.unavailable("This method is not available on this platform.")
+    }
+
+    private func resolveCall(_ call: CAPPluginCall) {
+        call.resolve()
+    }
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@capawesome/capacitor-shake",
+  "version": "0.0.1",
+  "description": "Capacitor plugin to detect shake gestures.",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Plugin/",
+    "CapawesomeCapacitorShake.podspec",
+    "Package.swift"
+  ],
+  "author": "Robin Genz <mail@robingenz.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/capawesome-team/capacitor-plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/capawesome-team/capacitor-plugins/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/capawesome-team/"
+    },
+    {
+      "type": "opencollective",
+      "url": "https://opencollective.com/capawesome"
+    }
+  ],
+  "homepage": "https://capawesome.io/docs/plugins/shake/",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api ShakePlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "ios:pod:install": "cd ios && pod install --repo-update && cd ..",
+    "ios:spm:install": "cd ios && swift package resolve && cd ..",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "8.0.0",
+    "@capacitor/cli": "8.0.0",
+    "@capacitor/core": "8.0.0",
+    "@capacitor/docgen": "0.3.1",
+    "@capacitor/ios": "8.0.0",
+    "@ionic/eslint-config": "0.4.0",
+    "eslint": "8.57.0",
+    "prettier-plugin-java": "2.6.7",
+    "rimraf": "6.1.2",
+    "rollup": "4.53.3",
+    "swiftlint": "2.0.0",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}