Permissions Capacitor plugin

Using @capgo/capacitor-permissions

One TypeScript API to check and request runtime permissions on iOS, Android, and web with normalized status codes.

Install

bun add @capgo/capacitor-permissions
bunx cap sync

What This Plugin Exposes

• check - Read the current status of one permission without prompting.
• request - Request one permission from the user.
• checkMultiple - Check several permissions without prompting.
• requestMultiple - Request several permissions sequentially.
• shouldShowRationale - Whether Android should show a rationale before requesting again.
• openSettings - Open application or notification settings when access is blocked.
• requestPreciseLocation - Upgrade to precise location on iOS and fine location on Android.
• getPluginVersion - Returns the platform implementation version marker.

Example Usage

check and request

import { Permissions } from '@capgo/capacitor-permissions';

export async function ensureCamera(): Promise<boolean> {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'granted') return true;
  const { status: afterRequest } = await Permissions.request({ permission: 'camera' });
  return afterRequest === 'granted';
}

openSettings

import { Permissions } from '@capgo/capacitor-permissions';

document.getElementById('camera-settings')?.addEventListener('click', async () => {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'blocked') {
    await Permissions.openSettings({ type: 'application' });
  }
});

Full Reference

• GitHub: https://github.com/Cap-go/capacitor-permissions/
• Docs: /docs/plugins/permissions/