{"id":34610397,"url":"https://github.com/warting/permissions-ui","last_synced_at":"2025-12-24T14:09:21.205Z","repository":{"id":36979842,"uuid":"407474028","full_name":"warting/permissions-ui","owner":"warting","description":"Background location permissions request helper","archived":false,"fork":false,"pushed_at":"2025-12-19T06:36:07.000Z","size":15668,"stargazers_count":63,"open_issues_count":19,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-22T02:01:59.910Z","etag":null,"topics":["android","jetpack-compose","permissions"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/warting.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["warting"]}},"created_at":"2021-09-17T09:00:59.000Z","updated_at":"2025-11-21T09:59:23.000Z","dependencies_parsed_at":"2024-04-18T04:31:35.142Z","dependency_job_id":"c0034862-1e3f-4cac-9cdb-4f1cc1558058","html_url":"https://github.com/warting/permissions-ui","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/warting/permissions-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warting%2Fpermissions-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warting%2Fpermissions-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warting%2Fpermissions-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warting%2Fpermissions-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/warting","download_url":"https://codeload.github.com/warting/permissions-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warting%2Fpermissions-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28003726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","jetpack-compose","permissions"],"created_at":"2025-12-24T14:09:13.160Z","updated_at":"2025-12-24T14:09:21.197Z","avatar_url":"https://github.com/warting.png","language":"Kotlin","funding_links":["https://github.com/sponsors/warting"],"categories":[],"sub_categories":[],"readme":"[![Maven Central](https://maven-badges.herokuapp.com/maven-central/se.warting.permissionsui/permissionsui/badge.png)](https://maven-badges.herokuapp.com/maven-central/se.warting.permissionsui/permissionsui)\n[![Crowdin](https://badges.crowdin.net/permissions-ui/localized.svg)](https://crowdin.com/project/permissions-ui)\n\n# Permission UI\n\nA set of Android-UI components to make it easier to request permission in a user friendly way.\n\n## Access background location \nA jetpack compose module to easy request background location permission in a intuitive way.\n\n![happy case gif](screenshot/sdk12_happy_case.gif)\n\n## How to include in your project\nThe library is available via MavenCentral:\n```\nallprojects {\n    repositories {\n        // ...\n        mavenCentral()\n    }\n}\n```\n\nAdd it to your module dependencies:\n```\ndependencies {\n    implementation(\"se.warting.permissionsui:permissionsui:\u003clatest_version\u003e\")\n}\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eSnapshots of the development version are available in Sonatype's snapshots repository.\u003c/summary\u003e\n\u003cp\u003e\n\n[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/se.warting.permissionsui/permissionsui?server=https%3A%2F%2Foss.sonatype.org)](https://oss.sonatype.org/content/repositories/snapshots/se/warting/permissionsui/permissionsui/)\n\n```groovy\nallprojects {\n    repositories {\n        // ...\n        maven {\n            url 'https://oss.sonatype.org/content/repositories/snapshots/'\n        }\n    }\n}\n```\n\n\u003c/p\u003e\n\u003c/details\u003e\n\n## How to use\nAll you need to do is to call `LocationInBackgroundTutorialView`:\n```\nLocationInBackgroundTutorialView() {\n    // Permissions granted \n}\n```\n\n\nExample:\n```\nimport se.warting.permissionsui.backgroundlocation.LocationInBackgroundTutorialView\n\nclass MainActivity : ComponentActivity() {\n    override fun onCreate(savedInstanceState: Bundle?) {\n        super.onCreate(savedInstanceState)\n        setContent {\n            BackgroundLocationPermissionRationaleTheme {\n                Surface(color = MaterialTheme.colors.background) {\n                    LocationInBackgroundTutorialView() {\n                        // Permissions granted \n                    }\n                }\n            }\n        }\n    }\n}\n```\n\nIf you are not using compose in your app you can use `PermissionsUiContracts.RequestBackgroundLocation` See: [kotlin sample](app/src/main/java/se/warting/backgroundlocationpermissionrationale/ResultingActivity.kt) or [java sample](appjava/src/main/java/se/warting/backgroundlocationpermissionrationale/MainActivity.java)\n\nFor a full implementation see: [Full sample](app/src/main/java/se/warting/backgroundlocationpermissionrationale/MainActivity.kt)\n\n## Notes\nThis Library adds the following permissions to your app: \n- android.permission.ACCESS_COARSE_LOCATION\n- android.permission.ACCESS_FINE_LOCATION\n- android.permission.ACCESS_BACKGROUND_LOCATION\n\n## Samples\n| SDK | Happy case | Rationale case | Worst case |\n| --- | --- | --- | --- |\n| 10 | ![happy case gif](screenshot/sdk10_happy_case.gif) | ![rationale case gif](screenshot/sdk10_rationale_case.gif) | ![worst case gif](screenshot/sdk10_worst_case.gif) |\n| 12 | ![happy case gif](screenshot/sdk12_happy_case.gif) | ![rationale case gif](screenshot/sdk12_rationale_case.gif) | ![worst case gif](screenshot/sdk12_worst_case.gif) |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarting%2Fpermissions-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwarting%2Fpermissions-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarting%2Fpermissions-ui/lists"}