Skip to content

saf

One class for the Android Storage Access Framework — pickers, persisted permissions, file management, streaming read/write, recursive walk, and progress.

Flutter ≥ 3.10 Dart ≥ 3.0 minSdk 21 pana 150/150 MIT 
final saf = Saf();

final dir = await saf.pickDirectory();          // one prompt, persists across restarts
if (dir == null) return;

for (final f in await saf.list(dir.uri)) {
  print('${f.name} · ${f.length} B · ${f.mimeType}');
}

final doc = await saf.writeFileBytes(
    dir.uri, 'hello.txt', 'text/plain', utf8.encode('hi') as Uint8List);
final bytes = await saf.readFileBytes(doc.uri);

📂 One package

Everything SAF in a single Saf class — no pairing two libraries.

🔒 Persisted permissions

Grant once, reuse across app restarts. List grants with persistedPermissions().

🌊 Streaming I/O

readFileStream and one-call writeFileStream for large files — no session bookkeeping.

🚶 Recursive walk

walk() streams a whole directory tree; copyTo/moveTo recurse with progress.

🔗 Descriptors & thumbnails

openFileDescriptor / withFileDescriptor hand native APIs a live /proc/self/fd path; thumbnail() returns provider JPEG previews.

🎯 Typed errors

SafPermissionException, SafNotFoundException, … instead of raw PlatformException.

📱 Broad support

Dart ≥ 3.0, Flutter ≥ 3.10, Android minSdk 21 — wider than the alternatives.

Where to next