Granting necessary permissions

Help Article2 min read

CalmSignal only asks for the minimum permissions required to deliver nudges.

Why permissions are required

CalmSignal needs a small set of permissions so it can detect stress signals, show nudges, and sync insights across your devices. Without the required permissions, analysis and nudges may not work correctly.

All text and behavioral analysis remains on-device. Granting permissions does not mean your raw typed text is uploaded to our servers.

Required permissions by platform

iOS (Keyboard mode): Enable CalmSignal keyboard and turn on "Allow Full Access" so on-device CoreML analysis can run while typing.

Android: Enable Accessibility Service and Display over other apps so CalmSignal can detect stress context and show nudges in real time.

All platforms: Enable Notifications so you can actually receive nudges and reminders when stress patterns are detected.

How to enable on iOS

Open iOS Settings → General → Keyboard → Keyboards → CalmSignal, then enable "Allow Full Access."

Return to CalmSignal and complete onboarding checks. If prompted, also allow Notifications.

  • If CalmSignal keyboard does not appear, re-add it from "Add New Keyboard..."
  • If nudges are missing, check iOS Notifications for CalmSignal and ensure alerts are allowed
  • If analysis still appears inactive, force-close and reopen the app after enabling permissions

How to enable on Android

Open CalmSignal and follow the setup checklist. Enable Accessibility Service first, then enable Display over other apps.

For reliability, set battery mode to Unrestricted for CalmSignal so Android does not stop background monitoring.

  • Settings → Accessibility → CalmSignal Wellness Monitor → On
  • Settings → Special app access → Display over other apps → CalmSignal → Allow
  • Settings → Apps → CalmSignal → Battery → Unrestricted (recommended)

Optional health permissions

If you use Apple Watch or Wear OS, you can enable health/sensor sharing (heart rate, HRV, activity) for improved stress context.

These are optional. CalmSignal can still work without wearable permissions, but with reduced physiological insight.

How to confirm permissions are working

Open CalmSignal Settings → Permissions (or Setup Checklist) and verify each required permission shows as enabled.

Create a quick test in any app: type a short message, then wait briefly to confirm CalmSignal activity and nudge readiness.

Troubleshooting

If permissions keep resetting, check device-level restrictions (battery savers, focus modes, enterprise policies) and re-enable CalmSignal access.

If the app says permissions are enabled but behavior is still inactive, restart your device once and run onboarding checks again.

Still blocked? Contact peace@calmsignal.app with your device model, OS version, and a screenshot of the CalmSignal permissions screen.