{"_id":"@capawesome/capacitor-settings-launcher","_rev":"4-e22339668307b4bee94e05a76a32413b","name":"@capawesome/capacitor-settings-launcher","dist-tags":{"latest":"0.1.2"},"versions":{"0.0.1":{"name":"@capawesome/capacitor-settings-launcher","version":"0.0.1","keywords":["capacitor","plugin","native","settings","native settings"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-settings-launcher@0.0.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/settings-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"8cd5b17ded26e106b9136b73e58bf518c53ac4ca","tarball":"https://registry.npmjs.org/@capawesome/capacitor-settings-launcher/-/capacitor-settings-launcher-0.0.1.tgz","fileCount":33,"integrity":"sha512-q3xB9vtJ9Sw5t7a2si5RNAHtmKJs42dqlGlhkn74e7bTBrY66wnngF6h4qvhrMdptHdwU7EMC5+s1KQ5HJ6uIA==","signatures":[{"sig":"MEUCIQCQpmCV8XXB/lnCCiWxelNCG4YMwxBbr+z9pOtRdq4H5gIgDGCXrlSBbN65kQkyLqKQC7uf3KNTzGNMaDlNPC5noGA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":117622},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"6332353d69f1dac0a152e735399500de521e76d9","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api SettingsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"robingenz","email":"mail@robingenz.dev"},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.13.0","description":"Capacitor plugin to open native settings screens.","directories":{},"_nodeVersion":"24.16.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-settings-launcher_0.0.1_1783413573110_0.13927358038936766","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@capawesome/capacitor-settings-launcher","version":"0.1.0","keywords":["capacitor","plugin","native","settings","native settings","capacitor-plugin","open settings","app settings","notification settings","android settings","settings screen","permission settings"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-settings-launcher@0.1.0","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/settings-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"c8b47127712094953eb02adb3ac795f4127f0b0e","tarball":"https://registry.npmjs.org/@capawesome/capacitor-settings-launcher/-/capacitor-settings-launcher-0.1.0.tgz","fileCount":33,"integrity":"sha512-BNUOPzSP1j2BETM4zHaMppv4YX+jYGsPUoBtSw6lLPlppky0Jj4Mdt7cl/rhdPzJjikeqh6LiYOM7OZr/agshw==","signatures":[{"sig":"MEUCIGS5dA7wcixf+uHMgy7n15PcWRbN9V4IMSr3+Q/C1hwyAiEA2QyOUvSWsQJ6VDsJAgWRYuPOuzxfmMa77L7Hg3e9IUY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-settings-launcher@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":122808},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"1ce17b1fd14c43b2f1d5d3c2da82221e1d1dca37","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api SettingsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:de103d55-365c-49b8-bf94-ecbb80893049"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to open native settings screens on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-settings-launcher_0.1.0_1784015604018_0.7407540015707113","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@capawesome/capacitor-settings-launcher","version":"0.1.1","keywords":["capacitor","plugin","native","settings","native settings","capacitor-plugin","open settings","app settings","notification settings","android settings","settings screen","permission settings"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-settings-launcher@0.1.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/settings-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"22b373594f4d9df0b8410bf68b308e70c338d82d","tarball":"https://registry.npmjs.org/@capawesome/capacitor-settings-launcher/-/capacitor-settings-launcher-0.1.1.tgz","fileCount":33,"integrity":"sha512-SxNJ+SW1d5VQpUk9d+Ld770gdnqgr+VWOOBdeNo9feY3qnbOxH4ekn85XzG+ZPkSXcTUfkdXvKE0bTDW5CwZbg==","signatures":[{"sig":"MEUCIFg62uI+C6dAptqHMV3R/3b4eA5UqOrhEswOaFRi3q7qAiEAiR+s58o4BPahxtzetkzujGpuThYBRVEGgAJXiM8IQjs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-settings-launcher@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":122817},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"3e61f4b412f9f3f512c21169bb135bbb23a67e6d","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api SettingsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:de103d55-365c-49b8-bf94-ecbb80893049"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to open native settings screens on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-settings-launcher_0.1.1_1784103055146_0.823549172174886","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@capawesome/capacitor-settings-launcher","version":"0.1.2","description":"Capacitor plugin to open native settings screens on Android and iOS.","main":"dist/plugin.cjs.js","module":"dist/esm/index.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","author":{"name":"Robin Genz","email":"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/sdks/capacitor/settings-launcher/","keywords":["capacitor","plugin","native","settings","native settings","capacitor-plugin","open settings","app settings","notification settings","android settings","settings screen","permission settings"],"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 SettingsLauncherPlugin --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.4.2","@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.9.7","rimraf":"6.1.2","rollup":"4.62.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"},"gitHead":"7c1937ed10b7de86ca2c1cdc3539a2735fd69a00","_id":"@capawesome/capacitor-settings-launcher@0.1.2","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-5Jv7p+N3l+QWbDF2BA4rvRTtQDMu9NaZaagdM9akh8M6fdgAa1EAXbbUkbxNAT3fCufjeReWafWSvZvpOvJ+Dg==","shasum":"23b179eb47b4734bb37f485d7f8d4c92b35a2289","tarball":"https://registry.npmjs.org/@capawesome/capacitor-settings-launcher/-/capacitor-settings-launcher-0.1.2.tgz","fileCount":33,"unpackedSize":123202,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-settings-launcher@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFueZ82tP/duk4cSWuXhuIJh38ETkvSVG2X4zsYYiGyAAiEApxX601qirlUqYALnUoTJwrnmN13c+V1AVoHI0I/Apvk="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:de103d55-365c-49b8-bf94-ecbb80893049"}},"directories":{},"maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/capacitor-settings-launcher_0.1.2_1788337415994_0.6186866678726723"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T08:39:32.963Z","modified":"2026-09-02T08:23:36.440Z","0.0.1":"2026-07-07T08:39:33.250Z","0.1.0":"2026-07-14T07:53:24.152Z","0.1.1":"2026-07-15T08:10:55.300Z","0.1.2":"2026-09-02T08:23:36.132Z"},"bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","homepage":"https://capawesome.io/docs/sdks/capacitor/settings-launcher/","keywords":["capacitor","plugin","native","settings","native settings","capacitor-plugin","open settings","app settings","notification settings","android settings","settings screen","permission settings"],"repository":{"type":"git","url":"git+https://github.com/capawesome-team/capacitor-plugins.git"},"description":"Capacitor plugin to open native settings screens on Android and iOS.","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"readme":"# Capacitor Settings Launcher Plugin\n\nCapacitor plugin to open native settings screens.\n\n<div class=\"capawesome-z29o10a\">\n  <a href=\"https://cloud.capawesome.io/\" target=\"_blank\">\n    <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\" />\n  </a>\n</div>\n\n## Features\n\n- ⚙️ **App settings**: Open the settings screen of your app to guide users to grant a denied permission.\n- 🔔 **Notification settings**: Open the notification settings screen of your app.\n- 🤖 **Android settings**: Open a large catalog of Android system settings screens.\n- 🔒 **App Store safe**: Uses only official platform APIs — no private URL schemes.\n- 🤝 **Compatibility**: Works alongside the [App Language](https://capawesome.io/docs/sdks/capacitor/app-language/) and [Android Battery Optimization](https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/) plugins.\n- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.\n- 🔁 **Up-to-date**: Always supports the latest Capacitor version.\n\nMissing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!\n\n## Use Cases\n\nThe Settings Launcher plugin is typically used to guide users to the right system settings screen, for example:\n\n- **Permission recovery**: Open your app's settings screen so users can grant a previously denied permission.\n- **Notification opt-in**: Guide users to your app's notification settings when notifications are disabled.\n- **Connectivity troubleshooting**: Open the Wi-Fi, Bluetooth, or airplane mode settings on Android when your app requires a connection.\n- **Onboarding flows**: Send users to Android settings screens such as locale, location, or NFC to enable features your app depends on.\n\n## Compatibility\n\n| Plugin Version | Capacitor Version | Status         |\n| -------------- | ----------------- | -------------- |\n| 0.x.x          | >=8.x.x           | Active support |\n\n## Installation\n\nYou can use our **AI-Assisted Setup** to install the plugin.\nAdd the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:\n\n```bash\nnpx skills add capawesome-team/skills --skill capacitor-plugins\n```\n\nThen use the following prompt:\n\n```\n Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-settings-launcher` plugin in my project.\n```\n\nIf you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:\n\n```bash\nnpm install @capawesome/capacitor-settings-launcher\nnpx cap sync\n```\n\n### Android\n\nNo additional configuration is required for this plugin.\n\n### iOS\n\nThe `openNotificationSettings(...)` method requires iOS 16 or later. On older versions, the call rejects as unavailable.\n\n## Configuration\n\nNo configuration required for this plugin.\n\n## Usage\n\nThe following examples show how to open your app's settings screen, open your app's notification settings, and open an Android system settings screen.\n\n### Open the settings screen of your app\n\nOpen your app's settings screen, for example to guide users to grant a previously denied permission. Only available on Android and iOS:\n\n```typescript\nimport { SettingsLauncher } from '@capawesome/capacitor-settings-launcher';\n\nconst openAppSettings = async () => {\n  await SettingsLauncher.openAppSettings();\n};\n```\n\n### Open the notification settings of your app\n\nOpen your app's notification settings screen, for example when the user has disabled notifications. On iOS, this method requires iOS 16 or later and rejects on older versions. Only available on Android and iOS:\n\n```typescript\nimport { SettingsLauncher } from '@capawesome/capacitor-settings-launcher';\n\nconst openNotificationSettings = async () => {\n  await SettingsLauncher.openNotificationSettings();\n};\n```\n\n### Open an Android system settings screen\n\nUse the `AndroidSettingsPage` enum to open one of the many supported Android system settings screens, such as Wi-Fi, Bluetooth, or location. Only available on Android:\n\n```typescript\nimport { SettingsLauncher, AndroidSettingsPage } from '@capawesome/capacitor-settings-launcher';\n\nconst openAndroidSettings = async () => {\n  await SettingsLauncher.openAndroidSettings({\n    page: AndroidSettingsPage.Wifi,\n  });\n};\n```\n\n## API\n\n<docgen-index>\n\n* [`openAndroidSettings(...)`](#openandroidsettings)\n* [`openAppSettings()`](#openappsettings)\n* [`openNotificationSettings()`](#opennotificationsettings)\n* [Interfaces](#interfaces)\n* [Enums](#enums)\n\n</docgen-index>\n\n<docgen-api>\n<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->\n\n### openAndroidSettings(...)\n\n```typescript\nopenAndroidSettings(options: OpenAndroidSettingsOptions) => Promise<void>\n```\n\nOpen a specific Android system settings screen.\n\nOnly available on Android.\n\n| Param         | Type                                                                              |\n| ------------- | --------------------------------------------------------------------------------- |\n| **`options`** | <code><a href=\"#openandroidsettingsoptions\">OpenAndroidSettingsOptions</a></code> |\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### openAppSettings()\n\n```typescript\nopenAppSettings() => Promise<void>\n```\n\nOpen the settings screen of your app.\n\nThis is the recommended way to guide users to grant a previously denied\npermission.\n\nOnly available on Android and iOS.\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### openNotificationSettings()\n\n```typescript\nopenNotificationSettings() => Promise<void>\n```\n\nOpen the notification settings screen of your app.\n\nOn iOS, this method requires iOS 16 or later and rejects on older versions.\n\nOnly available on Android and iOS.\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### OpenAndroidSettingsOptions\n\n| Prop       | Type                                                                | Description                                 | Since |\n| ---------- | ------------------------------------------------------------------- | ------------------------------------------- | ----- |\n| **`page`** | <code><a href=\"#androidsettingspage\">AndroidSettingsPage</a></code> | The Android system settings screen to open. | 0.1.0 |\n\n\n### Enums\n\n\n#### AndroidSettingsPage\n\n| Members                         | Value                                      | Description                                                                                               | Since |\n| ------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------- | ----- |\n| **`Accessibility`**             | <code>'ACCESSIBILITY'</code>               | Show settings for accessibility modules.                                                                  | 0.1.0 |\n| **`AirplaneMode`**              | <code>'AIRPLANE_MODE'</code>               | Show settings to allow entering/exiting airplane mode.                                                    | 0.1.0 |\n| **`Apn`**                       | <code>'APN'</code>                         | Show settings to allow configuration of APNs.                                                             | 0.1.0 |\n| **`BatterySaver`**              | <code>'BATTERY_SAVER'</code>               | Show settings to allow configuration of battery saver mode.                                               | 0.1.0 |\n| **`Bluetooth`**                 | <code>'BLUETOOTH'</code>                   | Show settings to allow configuration of Bluetooth.                                                        | 0.1.0 |\n| **`Captioning`**                | <code>'CAPTIONING'</code>                  | Show settings for video captioning.                                                                       | 0.1.0 |\n| **`CastSettings`**              | <code>'CAST_SETTINGS'</code>               | Show settings to allow configuration of cast endpoints.                                                   | 0.1.0 |\n| **`DataRoaming`**               | <code>'DATA_ROAMING'</code>                | Show settings for selection of 2G/3G.                                                                     | 0.1.0 |\n| **`Date`**                      | <code>'DATE'</code>                        | Show settings to allow configuration of date and time.                                                    | 0.1.0 |\n| **`Development`**               | <code>'DEVELOPMENT'</code>                 | Show settings to allow configuration of application development settings.                                 | 0.1.0 |\n| **`DeviceInfo`**                | <code>'DEVICE_INFO'</code>                 | Show general device information settings (serial number, software version, phone number, etc.).           | 0.1.0 |\n| **`Display`**                   | <code>'DISPLAY'</code>                     | Show settings to allow configuration of display.                                                          | 0.1.0 |\n| **`Dream`**                     | <code>'DREAM'</code>                       | Show Daydream settings.                                                                                   | 0.1.0 |\n| **`Home`**                      | <code>'HOME'</code>                        | Show settings for selecting the default home app.                                                         | 0.1.0 |\n| **`IgnoreBatteryOptimization`** | <code>'IGNORE_BATTERY_OPTIMIZATION'</code> | Show screen for controlling which apps can ignore battery optimizations.                                  | 0.1.0 |\n| **`InputMethod`**               | <code>'INPUT_METHOD'</code>                | Show settings to configure input methods, in particular allowing the user to enable input methods.        | 0.1.0 |\n| **`InternalStorage`**           | <code>'INTERNAL_STORAGE'</code>            | Show settings for internal storage.                                                                       | 0.1.0 |\n| **`Locale`**                    | <code>'LOCALE'</code>                      | Show settings to allow configuration of locale.                                                           | 0.1.0 |\n| **`Location`**                  | <code>'LOCATION'</code>                    | Show settings to allow configuration of current location sources.                                         | 0.1.0 |\n| **`ManageAllApplications`**     | <code>'MANAGE_ALL_APPLICATIONS'</code>     | Show settings to manage all applications.                                                                 | 0.1.0 |\n| **`ManageApplications`**        | <code>'MANAGE_APPLICATIONS'</code>         | Show settings to manage installed applications.                                                           | 0.1.0 |\n| **`MemoryCard`**                | <code>'MEMORY_CARD'</code>                 | Show settings for memory card storage.                                                                    | 0.1.0 |\n| **`Network`**                   | <code>'NETWORK'</code>                     | Show settings for selecting the network operator.                                                         | 0.1.0 |\n| **`Nfc`**                       | <code>'NFC'</code>                         | Show settings to allow configuration of NFC.                                                              | 0.1.0 |\n| **`NfcPayment`**                | <code>'NFC_PAYMENT'</code>                 | Show settings to allow configuration of tap and pay.                                                      | 0.1.0 |\n| **`NotificationListener`**      | <code>'NOTIFICATION_LISTENER'</code>       | Show settings for managing which apps have access to notification listener services.                      | 0.1.0 |\n| **`Printing`**                  | <code>'PRINTING'</code>                    | Show settings for printing.                                                                               | 0.1.0 |\n| **`Privacy`**                   | <code>'PRIVACY'</code>                     | Show settings to allow configuration of privacy options.                                                  | 0.1.0 |\n| **`Search`**                    | <code>'SEARCH'</code>                      | Show settings to allow configuration of search.                                                           | 0.1.0 |\n| **`Security`**                  | <code>'SECURITY'</code>                    | Show settings to allow configuration of security and location privacy.                                    | 0.1.0 |\n| **`Sound`**                     | <code>'SOUND'</code>                       | Show settings to allow configuration of sound and volume.                                                 | 0.1.0 |\n| **`Sync`**                      | <code>'SYNC'</code>                        | Show settings to allow configuration of sync settings.                                                    | 0.1.0 |\n| **`Usage`**                     | <code>'USAGE'</code>                       | Show screen for controlling which apps can access usage statistics.                                       | 0.1.0 |\n| **`UserDictionary`**            | <code>'USER_DICTIONARY'</code>             | Show settings to manage the user input dictionary.                                                        | 0.1.0 |\n| **`VoiceInput`**                | <code>'VOICE_INPUT'</code>                 | Show settings to configure input methods, in particular allowing the user to enable voice input services. | 0.1.0 |\n| **`Vpn`**                       | <code>'VPN'</code>                         | Show settings to allow configuration of VPN.                                                              | 0.1.0 |\n| **`Wifi`**                      | <code>'WIFI'</code>                        | Show settings to allow configuration of Wi-Fi.                                                            | 0.1.0 |\n| **`Wireless`**                  | <code>'WIRELESS'</code>                    | Show settings to allow configuration of wireless controls such as Wi-Fi, Bluetooth and mobile networks.   | 0.1.0 |\n\n</docgen-api>\n\n## Migrating from `capacitor-native-settings`\n\nThis plugin replaces the single `open(...)` method of `capacitor-native-settings` with three explicit methods. Instead of passing an `optionAndroid` and `optionIOS` to a single method, call the method that matches your intent:\n\n| `capacitor-native-settings`                                | Settings Launcher                        |\n| ---------------------------------------------------------- | ---------------------------------------- |\n| `open({ optionAndroid: 'application_details', optionIOS: 'App' })` | `openAppSettings()`                      |\n| `open({ optionAndroid: 'app_notification', optionIOS: 'App' })`    | `openNotificationSettings()`             |\n| `open({ optionAndroid: '<page>', optionIOS: '...' })`      | `openAndroidSettings({ page: '<page>' })` |\n\nOn iOS, `openAppSettings()` and `openNotificationSettings()` cover the officially supported destinations. The various `optionIOS` deep links into specific iOS settings sections are intentionally not supported (see below).\n\n## iOS and the `App-Prefs:` URL scheme\n\nThis plugin deliberately does **not** provide deep links into specific iOS system settings sections (e.g. Wi-Fi, Bluetooth, Location). Those links rely on the private `App-Prefs:` URL scheme, which is not part of the public iOS API. Apps that use it risk rejection during App Store review, and Apple may break it without notice between iOS releases.\n\nInstead, this plugin only uses official Apple APIs: `UIApplication.openSettingsURLString` (your app's settings) and `openNotificationSettingsURLString` (your app's notification settings, iOS 16+). This is a deliberate design decision to keep your app App Store safe.\n\n## FAQ\n\n### How is this plugin different from other similar plugins?\n\nIt opens native settings screens through three explicit, fully typed methods — your app's settings, your app's notification settings, and a large catalog of Android system screens such as Wi-Fi, Bluetooth, and location — so each call clearly matches your intent. It relies only on official Apple and Android APIs and deliberately avoids the private `App-Prefs:` URL scheme, which keeps your app App Store safe. Actively maintained against the latest Capacitor version, it is built to guide users to exactly the right settings screen on Android and iOS.\n\n### How can I guide users to grant a previously denied permission?\n\nCall the `openAppSettings` method to open the settings screen of your app. This is the recommended way to let users grant a permission that they previously denied, since neither Android nor iOS shows the permission prompt again after a denial. See the [usage example](#open-the-settings-screen-of-your-app) above.\n\n### How does this plugin work with the Permissions plugin?\n\nUse the [Permissions](https://capawesome.io/docs/sdks/capacitor/permissions/) plugin's `checkPermissions()` method to detect a `denied` permission state, then call `openAppSettings()` from this plugin to send the user straight to your app's settings screen to grant it manually. The two plugins are commonly used together for this check-then-recover flow.\n\n### Why can't I open specific iOS settings sections like Wi-Fi or Bluetooth?\n\nDeep links into specific iOS system settings sections rely on the private `App-Prefs:` URL scheme, which is not part of the public iOS API. Apps that use it risk rejection during App Store review, and Apple may break it without notice between iOS releases. This plugin deliberately only uses official Apple APIs to keep your app App Store safe (see [iOS and the `App-Prefs:` URL scheme](#ios-and-the-app-prefs-url-scheme)).\n\n### Why does `openNotificationSettings` reject on iOS?\n\nThe `openNotificationSettings(...)` method requires iOS 16 or later. On older iOS versions, the call rejects as unavailable. The `openAppSettings()` method works on all supported iOS versions and also gives users access to the notification settings of your app.\n\n### Which Android settings screens can I open?\n\nThe `openAndroidSettings(...)` method supports a large catalog of Android system settings screens, including Wi-Fi, Bluetooth, location, locale, NFC, display, sound, and many more. See the `AndroidSettingsPage` enum in the [API reference](#api) for the complete list. This method is only available on Android.\n\n### How do I migrate from `capacitor-native-settings`?\n\nThis plugin replaces the single `open(...)` method of `capacitor-native-settings` with three explicit methods: `openAppSettings()`, `openNotificationSettings()` and `openAndroidSettings(...)`. See the [migration guide](#migrating-from-capacitor-native-settings) above for a mapping table.\n\n### Can I use this plugin with Ionic, React, Vue or Angular?\n\nYes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects.\n\n## Related Plugins\n\n- [Android Battery Optimization](https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/): Manage battery optimization settings and request exemptions on Android.\n- [Android Intent Launcher](https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/): Launch arbitrary Android intents.\n- [App Language](https://capawesome.io/docs/sdks/capacitor/app-language/): Manage the app's own language override, independent of the device language.\n- [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/): Check if an app can be opened and open it.\n- [Permissions](https://capawesome.io/docs/sdks/capacitor/permissions/): Check and request device permissions with a unified API.\n\n## Newsletter\n\nStay 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/).\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/settings-launcher/CHANGELOG.md).\n\n## License\n\nSee [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/settings-launcher/LICENSE).\n","readmeFilename":"README.md"}