Grant: Robust Permission Management for KMP

Production-ready, type-safe permission handling for Kotlin Multiplatform — handling the complex edge cases of Android and iOS flows.

---

⚡ Zero Boilerplate. Zero Lifecycle Binding. Zero Headache.

Grant is not just another permission library. It is a production-hardened engine designed to handle complex edge cases that lead to crashes and hangs in other solutions. Built for professionals who demand absolute reliability.

Explore Documentation • Quick Start • Why Grant? • Demo App

• 🎯 Pure Logic-First API — Works anywhere: ViewModels, Repositories, or Composables. No Activity or Fragment references required.
• 🛡️ iOS Crash-Guard — Automatically validates Info.plist keys before requesting, preventing the dreaded SIGABRT production crashes.
• 🔄 Android Process-Death Resilience — The only library that handles system-initiated process death gracefully with zero timeouts.
• ⚡ iOS Deadlock Fix — Built-in protection against the infamous Camera/Microphone first-request deadlock.
• 📦 17+ Native Permissions — Deep, native integration for Camera, Gallery (Partial access!), Location, Bluetooth, Motion, and more.
• 🛠️ Service Intelligence — Don't just check permissions; check if services (GPS, Bluetooth) are actually enabled.
• 🧩 Custom Extensibility — Use RawPermission to support new OS versions (Android 15+, iOS 18+) instantly without library updates.

class CameraViewModel(private val grantManager: GrantManager) : ViewModel() {
    // 💡 Works in pure common code!
    val cameraGrant = GrantHandler(
        grantManager = grantManager,
        grant = AppGrant.CAMERA,
        scope = viewModelScope
    )

    fun capturePhoto() {
        cameraGrant.request {
            // ✅ Only runs when permission is FULLY granted
            cameraEngine.startCapture()
        }
    }
}

@Composable
fun CameraScreen(viewModel: CameraViewModel) {
    // 💡 Handles Rationale, Denied, and Settings dialogs automatically
    GrantDialog(handler = viewModel.cameraGrant)

    IconButton(onClick = { viewModel.capturePhoto() }) {
        Icon(Icons.Default.Camera, contentDescription = "Capture")
    }
}

Most KMP permission libraries are simple wrappers around native APIs. Grant is an Architectural Solution.

Add the ultimate permission engine to your commonMain:

// shared/build.gradle.kts
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("dev.brewkits:grant-core:1.2.1")
            implementation("dev.brewkits:grant-compose:1.2.1") // Optional UI pack
        }
    }
}

[!IMPORTANT] For projects targeting Web (JS) or Desktop (JVM), please use an intermediate mobileMain source set. Read the Guide.

• Architecture Guide - How we handle concurrency and state.
• iOS Setup - Critical Info.plist configuration.
• Android Reliability - How we fix "Dead Clicks".
• Service Checking - Beyond just permissions.

We are on a mission to make permissions a "solved problem" for KMP. Join us!

1. Check out CONTRIBUTING.md.
2. Run ./gradlew :grant-core:allTests to ensure stability.
3. Submit your PR.

Grant is licensed under the Apache License 2.0. See LICENSE for details.