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 existProperty 'getInfoAsync' does not exist
- Runtime issues where
file.inforeturns a function instead of file metadata - Any code importing
import * as FileSystem from 'expo-file-system'