In this guide, you’ll learn how to:
  • Create and name buckets directly from Rocket chat.
  • Upload, display, and secure files in your app.

​
Before you begin

You’ll need:
  • A Supabase account with an active project.
  • Your Supabase account connected to Rocket.

​
What are Supabase Buckets?

Buckets are part of Supabase Storage. Think organized folders for images, docs, videos, and more inside your Supabase project.
  • Files live at paths inside a bucket.
  • Buckets are private by default, or you can make them public.
  • Rocket does not store user files. It connects your app to your bucket and wires the logic.
Why use buckets?
They keep files organized, secure, and fast. Hosted by Supabase, seamlessly used by Rocket.

​
Create or detect a bucket in Rocket

Rocket automatically checks and creates a Supabase bucket when a feature needs file storage.
You can also create and connect Supabase buckets right from Rocket. Just tell it what you need in chat.
Example:
“Create a public Supabase bucket called user-uploads for profile images under 5 MB.”
Rocket will:
  • Create the bucket in your connected Supabase project.
  • Set the privacy level and access rules.
  • Configure type-specific restrictions such as allowing only images or documents.
  • Apply file size limits if you specify them.
  • Configure upload logic and permissions.
  • Wire the bucket into your app’s backend.
No need to open your Supabase dashboard unless you want to manage or rename buckets manually.

​
Use buckets in your app

Once connected, you can:
  • Let users upload files such as images, documents, or media.
  • Display uploaded content directly in your UI.
  • Control access based on your app’s needs.
Need a new bucket later? Tell Rocket in chat which features should use it, and it will create and connect it for you.

​
Access control and best practices

  • Default behavior: Rocket sets bucket privacy for you and manages signed URLs.
  • Make it explicit if needed: Say private or public in your prompt if you want a specific setting.
  • Naming: Use lowercase, hyphenated names such as reports-2025 to avoid typos.
If you do not specify, Rocket will choose the privacy setting best suited for the bucket’s purpose. This ensures sensitive files stay private by default while public assets remain accessible.

​
Troubleshooting

​
Files do not appear in the UI

What you’ll see:
The upload appears to work, but no file is displayed in the app.
How to fix it:
  1. Ask Rocket:
    “Show uploaded images from user-uploads in the profile screen.”
  2. If a script or function popup appears, click Push to Supabase to apply the changes.

Buckets wired. Files flowing.

Your Rocket app now uses Supabase Storage with organized and secure file handling that takes only minutes to set up.
Need help?
Email us at support@rocket.new or join our Discord community.