> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocket.new/llms.txt
> Use this file to discover all available pages before exploring further.
# Storage buckets
> Connect Supabase Storage to your Rocket.new app - upload, manage, and secure files from chat.
export const LlmsDirective = () =>
For the complete documentation index, see llms.txt.
For a lightweight markdown version of this page, append .md to the URL.
;
Create and manage Supabase Storage buckets directly from Rocket chat. This guide covers creating buckets, uploading and displaying files, controlling access, and troubleshooting common issues.
## What are Supabase Buckets?
Buckets are part of Supabase Storage. Think of them as folders that hold files like images, documents, videos, and more inside your Supabase project.
* Files live at paths inside a named bucket.
* Buckets are private by default, but you can make them public.
* Rocket does not store your 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 and seamlessly used by Rocket.
## Create or detect a bucket in Rocket
Rocket automatically checks for a Supabase bucket when a feature needs file storage. If it does not exist, Rocket creates it.
You can also create and connect Supabase buckets by asking Rocket in chat. Describe what you need.
**Example:**
```plaintext wrap theme={null}
Create a public Supabase bucket called user-uploads for profile images under 10 MB.
```
Rocket will:
* Create the bucket in your connected Supabase project.
* Set the privacy level and access rules.
* Configure file type restrictions (e.g. only images or documents).
* Apply file size limits if specified.
* Set up upload logic and permissions.
* Connect the bucket to your app's backend.
You do not need to open the Supabase dashboard unless you want to rename or manage 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 another bucket later? Tell Rocket in chat what you need it for. It will create and connect it.
## Access control and best practices
* **By default**, Rocket sets privacy and manages signed URLs.
* **Want it public or private?** Say so in your prompt.
* **Name wisely:** Use lowercase, hyphenated names like `reports-2025` to avoid typos or errors.
If you do not specify, Rocket chooses the privacy setting based on the bucket's use. This keeps sensitive files private and public assets accessible.
## Troubleshooting
### Files do not appear in the UI
What you will see:
The upload completes, but the file does not show up in the app.
To fix this:
In chat, ask Rocket:
```plaintext wrap theme={null}
Show uploaded images from user-uploads in the profile screen.
```
If Rocket shows a script or function popup, click **Push to Supabase** to apply the changes.
Your Rocket app now uses Supabase Storage with organized and secure file handling set up in minutes.
***
## What's next?
Add backend logic deployed directly from chat.
See all Supabase features available in Rocket.