v0.0.6

What's new

This release adds more complete file writing and download support, along with documentation updates and an Android workspace fix.

Highlights

• Added appendFile() support for appending content to existing files
• Added binary-friendly read/write support with base64 encoding
• Expanded downloadFile() options:
  • custom headers
  • connection and read timeouts
  • progress interval control
  • optional progressId
  • optional mimeType
  • saveToDownloads support
• Fixed Android workspace/package conflict issues
• Improved documentation and wiki pages

Full Changelog

Full Changelog: 0.0.4...0.0.6

0.0.5

react-native-simple-fs v0.0.5

react-native-simple-fs v0.0.5 adds media library support and download progress events, plus a refreshed example app and documentation.

What's new

• Added media library support for iOS and Android
• Added saveImageToLibrary() to save a local image into Photos or Gallery
• Added getImages() to load recent images from the system media library
• Added deleteImageFromLibrary() to remove an image from the system media library
• Added downloadProgress event support during downloadFile(...)
• Improved the example app with updated demos for downloads and media workflows
• Expanded the README with clearer setup, permissions, and usage examples

Highlights

• File operations for app-local storage
• Export flow for Android Downloads and iOS Files picker
• Download progress tracking for remote file downloads
• Photo library save, list, and delete support
• Continued support for Expo Modules-based React Native apps on iOS and Android

Notes

• getImages() and deleteImageFromLibrary() require media library permissions
• iOS apps must provide the appropriate Info.plist photo library usage descriptions
• Expo Go is not supported because this package includes custom native code

Install

npm install react-native-simple-fs

v0.0.5-beta.1

react-native-simple-fs 0.0.5-beta.1

This beta adds system media library support and improves the example app and docs for easier testing and integration.

Added

• Added saveImageToLibrary(path, options?)
  Save a local image file into the system photo library on Android and iOS.

• Added getImages(options?)
  Read recent images from the system media library.

• Added new shared media types:

  • ReactNativeFilesystemImageAsset
  • ReactNativeFilesystemSaveImageOptions
  • ReactNativeFilesystemGetImagesOptions

• Added image asset fields:

  • id
  • uri
  • previewUri
  • filename
  • width
  • height
  • mimeType
  • size
  • creationTime
  • modificationTime

Android

• Added MediaStore-based save-to-library support
• Added MediaStore image listing support
• Added required Android image/media permissions

iOS

• Added Photo Library save support with PHPhotoLibrary
• Added Photo Library image listing with PHAsset
• Added preview thumbnail generation so photo library images can render correctly in the example app
• Added support requirements for:
  • NSPhotoLibraryUsageDescription
  • NSPhotoLibraryAddUsageDescription

Example app

• Added a dedicated Media Library demo flow
• Added image source selection:
  • Documents
  • Photos
  • Custom
• Added safer image path resolution for iOS
• Added default demo presets:
  • Image: https://i.pinimg.com/736x/b3/bc/45/b3bc459af204f37a4bdd78f991d5e6cf.jpg
  • PDF: https://pdfobject.com/pdf/sample.pdf
• Improved media results to show image cards instead of raw JSON
• Cleaned up the demo flow to make each function easier to test

Documentation

• Rewrote the README in a cleaner reference style
• Added API tables, parameter tables, return shape docs, examples, permission notes, and AI-friendly summaries

Testing

• Updated native/web tests for media APIs
• Updated example app tests for the new media flows

Notes

• This is a beta release
• Web imports are supported, but local filesystem methods still throw on web
• readFile() remains text-only and should not be used for binary files like images or PDFs

v0.0.4

What's new

This release improves file download handling across iOS and Android, especially for binary files like PDFs and images.

Highlights

• Added optional mimeType support to downloadFile(url, destinationPath, options?)
• Added exported ReactNativeFilesystemCommonMimeTypes constants for common file types
• Improved automatic file extension resolution when destinationPath has no extension
• Better support for binary downloads such as PDFs, images, and zip files
• Updated the example app to handle text vs binary downloads more clearly
• Expanded the README with updated usage guidance and examples

Example

import ReactNativeFilesystem, {
  ReactNativeFilesystemCommonMimeTypes,
} from 'react-native-simple-fs';

const result = await ReactNativeFilesystem.downloadFile(
  'https://pdfobject.com/pdf/sample.pdf',
  filePath,
  { mimeType: ReactNativeFilesystemCommonMimeTypes.Pdf }
);

v0.0.3

What's new

This release adds remote file download support and improves the example app and documentation.

Highlights

• Added downloadFile(url, destinationPath) for downloading files from http and https URLs
• Implemented native download support for both Android and iOS
• Improved the example app with a cleaner demo flow, drawer navigation, and better feature organization
• Added inline action feedback and toast notifications in the example app
• Refactored the example app into a smaller and more maintainable file structure
• Updated the README with clearer step-by-step usage, FAQ, support, contributing, security, and license sections
• Bumped package version to 0.0.3

Notes

• readFile() is intended for UTF-8 text files
• for binary files such as images, PDFs, or videos, use downloadFile() but do not read them back with readFile()

Example

const result = await ReactNativeFilesystem.downloadFile(
  'https://example.com/file.txt',
  destinationPath
);

v0.0.1

Initial public release of react-native-filesystem.

Highlights

• Added cross-platform local filesystem support for Expo / React Native
• Added text file read and write APIs
• Added directory creation and directory listing APIs
• Added file metadata lookup with stat
• Added file existence, delete, move, and copy operations
• Added typed directory helpers for Documents and custom paths
• Added Android Downloads support
• Added iOS Files export support through the native Files picker
• Added example app coverage and updated package documentation

Included APIs

• getDocumentsDirectory()
• exists(path)
• readFile(path)
• writeFile(path, contents)
• writeFileToDownloads(filename, contents, mimeType?)
• deleteFile(path)
• mkdir(path)
• readdir(path)
• stat(path)
• move(from, to)
• copy(from, to)

Notes

• On Android, writeFileToDownloads(...) writes directly to Downloads.
• On iOS, writeFileToDownloads(...) opens the Files picker so the user can choose where to save.
• Removed the default template/demo APIs so the package now focuses on real filesystem features only.

Support

• Website: https://nexa-tech-team.vercel.app/
• Email: cs.nexatech@gmail.com
• Alternate email: doank3442@gmail.com