# guolindev/PermissionX

An open source Android library that makes handling runtime permissions extremely easy.

Repository: https://github.com/guolindev/PermissionX
Canonical: https://ross.abutalabs.com/products/permissionx
Language: Kotlin
License: Apache-2.0
License Family: permissive
Topics: android, permissionx
Last push: 2024-08-29T12:28:33+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2500, "days_push": 734, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3658, forks 414 (observed 2026-08-28T04:08:13.243149+00:00)

## What it is
PermissionX is an open-source Android library written in Kotlin that simplifies requesting and handling Android runtime permissions. It supports basic permission requests as well as complex flows like rationale dialogs and directing users to app settings for manual permission grants.

## Use cases
- request android runtime permissions easily
- show rationale dialog when user denies permissions
- handle never ask again permission cases
- send users to app settings to grant permissions manually
- request multiple permissions like camera and contacts in one call

## When to choose
- you are building an Android app with FragmentActivity or Fragment and need runtime permission handling
- you want a simple chained API for permission requests with rationale and settings flows
- you prefer a lightweight Kotlin library over writing permission boilerplate yourself

## When to avoid
- you are not developing for Android
- your app targets only Android versions without runtime permissions
- you need Jetpack Compose-only permission APIs and prefer official Accompanist or Activity Result APIs

## Facets
- artifact type: library
- maturity: stable
- function: mobile-framework, developer-tools
- domain: mobile-development, android-tools, developer-tools
- platform: jvm
- tags: runtime-permissions, android-library, kotlin, permission-handling, android

## Member repositories
- guolindev/PermissionX (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:13.243149+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:31:36.676286+00:00, confidence not recorded.
  - readme: https://github.com/guolindev/PermissionX (fetched 2026-08-28T04:08:13.243149+00:00, sha 70001ed919c5)
- Data as of 2026-08-30T08:39:29.467469+00:00.