# google/modernstorage

ModernStorage is a group of libraries that provide an abstraction layer over storage on Android to simplify its interactions

Repository: https://github.com/google/modernstorage
Canonical: https://ross.abutalabs.com/products/modernstorage
Homepage: https://google.github.io/modernstorage/
Language: Kotlin
License: Apache-2.0
License Family: permissive
Topics: android, storage, mediastore, storage-access-framework, kotlin
Archived: true
Last push: 2023-06-27T09:25:01+00:00

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

## Adoption (not part of the score)
Stars 1227, forks 56 (observed 2026-08-28T04:04:03.344613+00:00)

## What it is
ModernStorage is a set of Kotlin libraries from Google that provide an abstraction layer over Android storage APIs, including the Storage Access Framework, MediaStore, and photo picker. It simplifies storage interactions and permission checking for Android app developers with a simpler, opinionated API.

## Use cases
- access files on Android without dealing with Storage Access Framework boilerplate
- check and request storage permissions on Android with a simple API
- interact with MediaStore for media files in an Android app
- use Okio FileSystem API to read and write Android storage
- launch the Android photo picker from an app
- simplify file storage code across Android API levels

## When to choose
- you are building an Android app in Kotlin that needs file or media storage access
- you want a simplified, opinionated wrapper over SAF, MediaStore, and storage permissions
- you prefer Okio's FileSystem API for storage interactions on Android

## When to avoid
- you need a stable, production-hardened library - it is still in alpha with expected API breaking changes
- you target platforms other than Android
- you need storage features beyond the library's intentionally small API surface

## Facets
- artifact type: library
- maturity: experimental
- function: file-system, sdk, developer-tools
- domain: android-tools, mobile-development, files, developer-tools
- platform: jvm
- tags: storage-access-framework, mediastore, photo-picker, permissions, okio, jetpack-compose, android

## Member repositories
- google/modernstorage (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:03.344613+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-30T06:15:15.357684+00:00, confidence not recorded.
  - readme: https://github.com/google/modernstorage (fetched 2026-08-28T04:04:03.344613+00:00, sha d64b5bbf8da2)
  - homepage: https://google.github.io/modernstorage/ (fetched 2026-08-29T12:22:52.995725+00:00, sha 119d3964d3b6)
- Data as of 2026-08-30T08:39:29.467469+00:00.