---

Permit

A command-line tool for managing permissions in Flutter projects. permit simplifies adding, removing, and listing permissions in AndroidManifest.xml and Info.plist.

---

Installation

dart pub global activate permit

---

Motivation & Features

• CLI-first: no Xcode or Android Studio opening, no manual file editing.
• Reduces the risk of store rejections by generating native permission code only for APIs your app actually uses.
• No key memorization: use keywords instead of platform-specific permission names.
• Usage descriptions on the fly: add iOS descriptions inline, or by follow-up prompts.
• Zero missing config: if runtime code exists, metadata exists in at least one platform config file.
• Simple localization: one command to generate and keep iOS permission strings in sync.
• Platform-scoped permissions: generate permissions and runtime code for Android or iOS independently.
• Instant auditing: list all added permissions and their runtime code status.
• Zero external dependencies: generates a local plugin you own and control—no third-party versioning issues.

---

Usage

permit <command> [options]

---

add Command

permit add <permission>

Adds permission metadata to the relevant platform files. Optionally, it can also generate runtime permission request code.

Supported Inputs

• Explicit platform keys

  • android.permission.CAMERA
  • NSCameraUsageDescription

• Searchable keywords

  • camera, location, microphone, etc.

If a keyword matches multiple permissions, you will be prompted to choose.

Examples

Add specific permission keys

permit add NSCameraUsageDescription
permit add android.permission.CAMERA

Platform detection is automatic; no flags are required.

Add permissions using keywords

permit add camera

If multiple matches are found:

Select permissions to add ›
[ ] Android: android.permission.CAMERA
[ ] iOS: NSCameraUsageDescription

Limit search to a platform

• [-a], [--android] → Android only
• [-i], [--ios] → iOS only

permit add contacts -a

Select permissions to add ›
[ ] Android: android.permission.READ_CONTACTS
[ ] Android: android.permission.WRITE_CONTACTS
[ ] Android: android.permission.GET_ACCOUNTS

Provide iOS usage descriptions inline

For iOS permissions, use [-d] / [--desc] to avoid interactive prompts:

permit add NSCameraUsageDescription -d "This app requires camera access to take photos."

Generate runtime permission code

By default, only metadata is added. To also generate runtime request code:

permit add camera -c

This will:

• Add permission metadata
• Generate runtime permission request code
• Create a minimal local plugin at tools/permit_plugin
• Automatically add the plugin to pubspec.yaml

Important

• Run flutter pub get after the plugin is added
• Hot-restart or rebuild after plugin updates
• Add command updates existing keys, you can use it to update usage descriptions as well

---

remove Command

permit remove <permission>

Removes permission metadata and any generated runtime code.

Supported Inputs

• Explicit permission keys
• Searchable keywords

Examples

Remove specific permission keys

permit remove NSCameraUsageDescription
permit remove android.permission.CAMERA

Platform detection is automatic.

Remove using keywords

permit remove camera

If multiple matches are found:

Select which permissions to remove ›
[ ] Android: android.permission.CAMERA
[ ] iOS: NSCameraUsageDescription

Remove interactively

If no argument is provided, all added permissions are listed:

permit remove

Select which permissions to remove ›
[ ] Android: android.permission.CAMERA
[ ] Android: android.permission.RECORD_AUDIO
[ ] iOS: NSCameraUsageDescription
[ ] iOS: NSMicrophoneUsageDescription

---

list Command

permit list

Lists all permissions currently added to the project.

Example

permit list

Android: Uses Permissions (2):
  - android.permission.CAMERA [CODE]
  - android.permission.RECORD_AUDIO

iOS: Usage Descriptions (2):
  - NSCameraUsageDescription: This is used to record videos
  - NSMicrophoneUsageDescription: We need mic access to record audio with the video

[CODE] indicates that runtime permission code has been generated.

Platform filtering

• [-a], [--android] → Android only
• [-i], [--ios] → iOS only

permit list -a

---

localize Command (iOS only)

permit localize [language_codes...]

Generates or updates InfoPlist.xcstrings with localized usage description keys.

Behavior

• Adds missing keys only; never removes existing ones

• Respects:

  • Known region languages defined in the iOS project
  • Existing keys in InfoPlist.xcstrings

• Language codes are not validated—use valid Apple locale identifiers

Language codes must be space-separated:

en ar_LY it fr

Examples

Generate localization for specific languages

permit localize en ar_LY it

Update all supported languages

If no arguments are passed:

permit localize

This updates existing localization files with any new permission keys.

Add additional languages

permit localize fr de

Creates French and German localization files if they don’t already exist.

---

build Command

permit build

Rebuilds runtime permission code based on the current platform permission metadata.

When to use

• After manually modifying the generated plugin
• To regenerate code from existing permission entries

NOTE: it's automatically run after add with the -c flag or removing permissions

permit detects which permissions require runtime code using the annotation:

<!--@permit:code-->

Examples

AndroidManifest.xml

<!--@permit:code-->
<uses-permission android:name="android.permission.CAMERA" />

Info.plist

<!--@permit:code-->
<key>NSCameraUsageDescription</key><string>This app requires camera access to take photos.</string>

Generated Code

The generated code is placed in tools/permit_plugin/lib/permit.dart. E.g after adding camera permission with code generation:

import 'package:permit_plugin/permit.dart';

// check permission status
final status = await Permit.camera.status;

switch(status){
    case PermissionStatus.denied:
    // Permission was denied or not yet requested.
    case PermissionStatus.granted:
    //  Permission was granted.
    case PermissionStatus.restricted:
    //  Permission is restricted (iOS only).
    case PermissionStatus.limited:
    //  Permission is limited (iOS only).
    case PermissionStatus.permanentlyDenied:
    //  Permission is permanently denied, user must enable it from settings.
    case PermissionStatus.provisional:
    // Permission is provisional (iOS only).
    case PermissionStatus.notApplicable:
    // Permission is not applicable for this platform, either not supported or not added in config files.
}

// request permission
final status = await Permit.camera.request();

// some permissions report service status
final serviceStatus = await Permit.location.serviceStatus;

// check if you should show rationale on Android
final shouldShowRationale = await Permit.microphone.shouldShowRequestRationale;

// open app settings
final wasOpened = await Permit.openSettings();

---

Support Permit

If you find permit useful, consider supporting the project by liking it, sharing it, or buying a coffee!