expo-file-system

npx expo install expo-file-system

import { Directory, File, Paths } from "expo-file-system";
 
export function ensureDownloadDir() {
  const dir = new Directory(Paths.cache, "downloads");
  if (!dir.exists) {
    dir.create();
  }
  return dir;
}
 
export async function downloadPdf(url: string, filename: string) {
  const dir = ensureDownloadDir();
  const output = await File.downloadFileAsync(url, dir);
  return output.uri;
}
 
export function writeJsonCache(name: string, data: unknown) {
  const file = new File(Paths.cache, `${name}.json`);
  if (!file.exists) {
    file.create();
  }
  file.write(JSON.stringify(data));
}

npx expo install expo-file-system

// src/files/downloadWithProgress.ts
import { Directory, File, Paths } from "expo-file-system";
 
export async function downloadInspectionPdf(
  url: string,
  jobId: string,
  onProgress: (ratio: number) => void
) {
  const dir = new Directory(Paths.document, "inspections", jobId);
  if (!dir.exists) {
    dir.create({ intermediates: true });
  }
 
  const destination = new File(dir, "report.pdf");
  const task = File.createDownloadTask(url, destination, {
    onProgress: ({ bytesWritten, totalBytes }) => {
      if (totalBytes > 0) {
        onProgress(bytesWritten / totalBytes);
      }
    },
  });
 
  const file = await task.downloadAsync();
  if (!file) throw new Error("Download paused or cancelled");
 
  const meta = new File(dir, "meta.json");
  meta.create();
  meta.write(JSON.stringify({ url, downloadedAt: Date.now() }));
 
  return file.uri;
}

// src/files/listInspections.ts
import { Directory, Paths } from "expo-file-system";
 
export function listInspectionJobIds(): string[] {
  const root = new Directory(Paths.document, "inspections");
  if (!root.exists) return [];
 
  return root
    .list()
    .filter((entry) => entry instanceof Directory)
    .map((d) => d.name);
}

// src/files/legacyRead.ts - temporary bridge
import * as FileSystem from "expo-file-system/legacy";
import { File, Paths } from "expo-file-system";
 
export async function readLegacyManifest() {
  const file = new File(Paths.cache, "legacy-manifest.json");
  if (!file.exists) return null;
  const text = await FileSystem.readAsStringAsync(file.uri);
  return JSON.parse(text) as { version: number };
}

import { Paths } from "expo-file-system";
 
console.log(Paths.document.uri);
console.log(Paths.cache.uri);

const dir = new Directory(Paths.cache, "avatars");
dir.create({ intermediates: true });
 
const avatar = dir.createFile("user-42.jpg", "image/jpeg");
avatar.write(bytes);
 
const copy = new File(Paths.cache, "avatars", "user-42-copy.jpg");
avatar.copy(copy);
 
avatar.move(new Directory(Paths.document, "archive"));

// Simple one-shot download
await File.downloadFileAsync(url, new Directory(Paths.cache, "pdfs"));
 
// Upload with progress
const file = new File(Paths.document, "photo.jpg");
const task = file.createUploadTask("https://api.example.com/upload", {
  uploadType: File.UploadType?.MULTIPART ?? 1,
  onProgress: ({ bytesSent, totalBytes }) => {
    console.log(bytesSent, totalBytes);
  },
});
await task.uploadAsync();

// Before (legacy)
import * as FileSystem from "expo-file-system/legacy";
await FileSystem.readAsStringAsync(uri);
 
// After (SDK 57)
import { File } from "expo-file-system";
const file = new File(uri);
const text = file.textSync();

{
  "expo": {
    "plugins": [
      [
        "expo-file-system",
        {
          "enableFileSharing": true,
          "supportsOpeningDocumentsInPlace": true
        }
      ]
    ]
  }
}