SETUP INSTRUCTIONS
1. Install the plugin in your Bubble app

2. In any workflow, add action → File Downloader Native → Download File

3. Fill in the fields:
  - File URL: the direct URL to the file you want to download
    (must be a direct file link, not a webpage)
  - File name (optional): custom name for the downloaded file
    e.g. "invoice_2024.pdf" — if left empty, name is taken from the URL

4. How files are saved:
  - Images (jpg, png, gif, webp, heic) → saved to camera roll/gallery
  - Videos (mp4, mov, avi, mkv) → saved to camera roll/gallery
  - PDFs, docs, audio, zip, and all other files → opens native share sheet
    where user can save to Files app, open in another app, or share

5. Camera roll permission is requested automatically on first use
  — user must approve it for images and videos to save correctly

COMMON ISSUES:
- File not downloading → make sure the URL is a direct file link, not a redirect or webpage
- Permission denied → user must allow camera roll access in device settings
- Wrong file type detected → use the File name field with the correct extension

⚠️ TESTING WARNING:
This plugin will NOT work in Bubble web preview.
Always test using BubbleGo or your published native mobile app.