Storage Diagnostics

About

Storage Diagnostics provides a systematic framework for troubleshooting local file system issues in iOS, iPadOS, watchOS, and tvOS applications. It identifies common pitfalls such as incorrect storage locations like tmp or Caches, file protection level mismatches that block background access, and unnecessary backup bloat. By offering diagnostic code snippets and structured decision trees, it helps developers distinguish between expected system behaviors and implementation bugs, ensuring reliable data persistence and compliance with Apple's storage guidelines.

Key Features

• Systematic diagnostic scripts for file locations, protection levels, and backup status
• Decision trees for troubleshooting disappeared files and 'permission denied' errors
• Strategies for reducing app backup size and managing exclusion keys
• 61 GitHub stars
• Implementation patterns for managing background task file accessibility
• Guidance on system-level purge behaviors for different directories

Use Cases

• Debugging 'file not found' errors occurring after device restarts or app backgrounding
• Optimizing app storage to prevent excessively large iCloud backups
• Resolving permission issues when background tasks access files while the device is locked