genio-learn · sizeak · Mar 12, 2026 · Mar 12, 2026 · Mar 12, 2026 · Mar 12, 2026
diff --git a/.changeset/add-notification-tapped-listener.md b/.changeset/add-notification-tapped-listener.md
@@ -0,0 +1,5 @@
+---
+"@capawesome-team/capacitor-android-foreground-service": minor
+---
+
+feat(android): add `notificationTapped` event listener
diff --git a/packages/accelerometer/README.md b/packages/accelerometer/README.md
@@ -23,6 +23,10 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 
 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         |
@@ -32,7 +36,7 @@ Missing a feature? Just [open an issue](https://github.com/capawesome-team/capac
 
 ## Installation
 
-This plugin is only available to [Capawesome Insiders](https://capawesome.io/sponsors/insiders/). 
+This plugin is only available to [Capawesome Insiders](https://capawesome.io/insiders/). 
 First, make sure you have the Capawesome npm registry set up.
 You can do this by running the following commands:
 
@@ -41,11 +45,24 @@ npm config set @capawesome-team:registry https://npm.registry.capawesome.io
 npm config set //npm.registry.capawesome.io/:_authToken <YOUR_LICENSE_KEY>
 ```
 
-**Attention**: Replace `<YOUR_LICENSE_KEY>` with the license key you received from Polar. If you don't have a license key yet, you can get one by becoming a [Capawesome Insider](https://capawesome.io/sponsors/insiders/).
+**Attention**: Replace `<YOUR_LICENSE_KEY>` with the license key you received from Polar. If you don't have a license key yet, you can get one by becoming a [Capawesome Insider](https://capawesome.io/insiders/).
+
+Next, you can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
 
-Next, install the package:
+Then use the following prompt:
 
 ```
+Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome-team/capacitor-accelerometer` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
 npm install @capawesome-team/capacitor-accelerometer
 npx cap sync
 ```

diff --git a/packages/age-signals/README.md b/packages/age-signals/README.md
@@ -22,6 +22,10 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 
 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         |
@@ -31,6 +35,21 @@ Missing a feature? Just [open an issue](https://github.com/capawesome-team/capac
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-age-signals` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome/capacitor-age-signals
 npx cap sync

diff --git a/packages/android-battery-optimization/README.md b/packages/android-battery-optimization/README.md
@@ -8,6 +8,10 @@ Capacitor plugin for Android to manage battery optimization settings, request ex
   </a>
 </div>
 
+## 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         |
@@ -16,6 +20,21 @@ Capacitor plugin for Android to manage battery optimization settings, request ex
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome-team/capacitor-android-battery-optimization` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome-team/capacitor-android-battery-optimization
 npx cap sync

diff --git a/packages/android-dark-mode-support/README.md b/packages/android-dark-mode-support/README.md
@@ -8,6 +8,10 @@ Capacitor plugin for seamless Android dark mode support. Enhance user experience
   </a>
 </div>
 
+## 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         |
@@ -16,6 +20,21 @@ Capacitor plugin for seamless Android dark mode support. Enhance user experience
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-android-dark-mode-support` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome/capacitor-android-dark-mode-support
 npx cap sync

diff --git a/packages/android-edge-to-edge-support/README.md b/packages/android-edge-to-edge-support/README.md
@@ -14,6 +14,10 @@ Capacitor plugin to support [edge-to-edge](https://developer.android.com/develop
 
 **Attention:** Despite its name, this plugin doesn't enable edge-to-edge mode by default. Instead, it preserves the traditional app behavior by applying proper insets to the webview, preventing Android's edge-to-edge changes from affecting apps that haven't been designed to support it.
 
+## 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         |
@@ -23,6 +27,21 @@ Capacitor plugin to support [edge-to-edge](https://developer.android.com/develop
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-android-edge-to-edge-support` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome/capacitor-android-edge-to-edge-support
 npx cap sync

diff --git a/packages/android-foreground-service/README.md b/packages/android-foreground-service/README.md
@@ -8,6 +8,10 @@ Capacitor plugin to run a foreground service on Android.
   </a>
 </div>
 
+## 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         |
@@ -16,6 +20,21 @@ Capacitor plugin to run a foreground service on Android.
 
 ## Installation
 
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the Capawesome Skills to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills
+```
+
+Then use the following prompt:
+
+```
+Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome-team/capacitor-android-foreground-service` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
 ```bash
 npm install @capawesome-team/capacitor-android-foreground-service
 npx cap sync
@@ -117,21 +136,50 @@ const deleteNotificationChannel = async () => {
 
 <docgen-index>
 
-* [`moveToForeground()`](#movetoforeground)
-* [`startForegroundService(...)`](#startforegroundservice)
-* [`updateForegroundService(...)`](#updateforegroundservice)
-* [`stopForegroundService()`](#stopforegroundservice)
-* [`checkPermissions()`](#checkpermissions)
-* [`requestPermissions()`](#requestpermissions)
-* [`checkManageOverlayPermission()`](#checkmanageoverlaypermission)
-* [`requestManageOverlayPermission()`](#requestmanageoverlaypermission)
-* [`createNotificationChannel(...)`](#createnotificationchannel)
-* [`deleteNotificationChannel(...)`](#deletenotificationchannel)
-* [`addListener('buttonClicked', ...)`](#addlistenerbuttonclicked-)
-* [`removeAllListeners()`](#removealllisteners)
-* [Interfaces](#interfaces)
-* [Type Aliases](#type-aliases)
-* [Enums](#enums)
+- [@capawesome-team/capacitor-android-foreground-service](#capawesome-teamcapacitor-android-foreground-service)
+  - [Newsletter](#newsletter)
+  - [Compatibility](#compatibility)
+  - [Installation](#installation)
+    - [Android](#android)
+  - [Configuration](#configuration)
+  - [Demo](#demo)
+  - [Usage](#usage)
+  - [API](#api)
+    - [moveToForeground()](#movetoforeground)
+    - [startForegroundService(...)](#startforegroundservice)
+    - [updateForegroundService(...)](#updateforegroundservice)
+    - [stopForegroundService()](#stopforegroundservice)
+    - [checkPermissions()](#checkpermissions)
+    - [requestPermissions()](#requestpermissions)
+    - [checkManageOverlayPermission()](#checkmanageoverlaypermission)
+    - [requestManageOverlayPermission()](#requestmanageoverlaypermission)
+    - [createNotificationChannel(...)](#createnotificationchannel)
+    - [deleteNotificationChannel(...)](#deletenotificationchannel)
+    - [addListener('buttonClicked', ...)](#addlistenerbuttonclicked-)
+    - [addListener('notificationTapped', ...)](#addlistenernotificationtapped-)
+    - [removeAllListeners()](#removealllisteners)
+    - [Interfaces](#interfaces)
+      - [StartForegroundServiceOptions](#startforegroundserviceoptions)
+      - [NotificationButton](#notificationbutton)
+      - [PermissionStatus](#permissionstatus)
+      - [ManageOverlayPermissionResult](#manageoverlaypermissionresult)
+      - [CreateNotificationChannelOptions](#createnotificationchanneloptions)
+      - [DeleteNotificationChannelOptions](#deletenotificationchanneloptions)
+      - [PluginListenerHandle](#pluginlistenerhandle)
+      - [ButtonClickedEvent](#buttonclickedevent)
+      - [NotificationTappedEvent](#notificationtappedevent)
+    - [Type Aliases](#type-aliases)
+      - [UpdateForegroundServiceOptions](#updateforegroundserviceoptions)
+      - [PermissionState](#permissionstate)
+      - [ButtonClickedEventListener](#buttonclickedeventlistener)
+      - [NotificationTappedEventListener](#notificationtappedeventlistener)
+    - [Enums](#enums)
+      - [ServiceType](#servicetype)
+      - [Importance](#importance)
+  - [FAQ](#faq)
+    - [Why can the user dismiss the notification?](#why-can-the-user-dismiss-the-notification)
+  - [Changelog](#changelog)
+  - [License](#license)
 
 </docgen-index>
 
@@ -344,6 +392,28 @@ Only available on iOS.
 --------------------
 
 
+### addListener('notificationTapped', ...)
+
+```typescript
+addListener(eventName: 'notificationTapped', listenerFunc: NotificationTappedEventListener) => Promise<PluginListenerHandle>
+```
+
+Called when the foreground service notification is tapped.
+
+Only available on Android.
+
+| Param              | Type                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'notificationTapped'</code>                                                             |
+| **`listenerFunc`** | <code><a href="#notificationtappedeventlistener">NotificationTappedEventListener</a></code>   |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 8.1.0
+
+--------------------
+
+
 ### removeAllListeners()
 
 ```typescript
@@ -427,6 +497,13 @@ Remove all listeners for this plugin.
 | **`buttonId`** | <code>number</code> | The button identifier. | 0.2.0 |
 
 
+#### NotificationTappedEvent
+
+| Prop                 | Type                | Description                  | Since |
+| -------------------- | ------------------- | ---------------------------- | ----- |
+| **`notificationId`** | <code>number</code> | The notification identifier. | 8.1.0 |
+
+
 ### Type Aliases
 
 
@@ -445,6 +522,11 @@ Remove all listeners for this plugin.
 <code>(event: <a href="#buttonclickedevent">ButtonClickedEvent</a>): void</code>
 
 
+#### NotificationTappedEventListener
+
+<code>(event: <a href="#notificationtappedevent">NotificationTappedEvent</a>): void</code>
+
+
 ### Enums
 
 

diff --git a/...in/java/io/capawesome/capacitorjs/plugins/foregroundservice/AndroidForegroundService.java b/...in/java/io/capawesome/capacitorjs/plugins/foregroundservice/AndroidForegroundService.java
@@ -77,15 +77,19 @@ public int onStartCommand(Intent intent, int flags, int startId) {
     }
 
     private PendingIntent buildContentIntent(int id) {
-        String packageName = getApplicationContext().getPackageName();
-        Intent intent = getApplicationContext().getPackageManager().getLaunchIntentForPackage(packageName);
+        Intent launchIntent = getPackageManager().getLaunchIntentForPackage(getPackageName());
+        if (launchIntent == null) {
+            return null;
+        }
+        launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+        launchIntent.putExtra(ForegroundServicePlugin.NOTIFICATION_TAP_EXTRA, id);
         int pendingIntentFlags;
         if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            pendingIntentFlags = PendingIntent.FLAG_CANCEL_CURRENT | PendingIntent.FLAG_MUTABLE;
+            pendingIntentFlags = PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE;
         } else {
-            pendingIntentFlags = PendingIntent.FLAG_CANCEL_CURRENT;
+            pendingIntentFlags = PendingIntent.FLAG_UPDATE_CURRENT;
         }
-        return PendingIntent.getActivity(getApplicationContext(), id, intent, pendingIntentFlags);
+        return PendingIntent.getActivity(getApplicationContext(), id, launchIntent, pendingIntentFlags);
     }
 
     private Notification.Action[] convertBundlesToNotificationActions(Bundle[] bundles) {