expo-file-system-class-api-migration

Installation
SKILL.md

Expo File System Class API Migration

Problem

After upgrading to Expo SDK 52+ (expo-file-system 18+), the legacy function-based API no longer works. Code using FileSystem.deleteAsync(), FileSystem.getInfoAsync(), FileSystem.cacheDirectory, etc. will fail with TypeScript errors or runtime issues.

Context / Trigger Conditions

You'll encounter this when:

  • Upgrading Expo SDK from 51 or earlier to 52+
  • TypeScript errors like:
    • Property 'cacheDirectory' does not exist on type 'typeof import("expo-file-system")'
    • Module '"expo-file-system"' has no exported member 'EncodingType'
    • Property 'deleteAsync' does not exist
    • Property 'getInfoAsync' does not exist
  • Runtime issues where file.info returns a function instead of file metadata
  • Any code importing import * as FileSystem from 'expo-file-system'
Installs
1
First Seen
Apr 1, 2026