mirror of
https://github.com/supabase/supabase.git
synced 2026-10-15 14:19:11 +03:00
Ivan Vasilov
429aa9d084
* Add realtime chat to the landing page. * Fix the realtime cursor demo on the landing page. * Fix a bad spelling of shadcn. * Fix the wrong link in RR auth. * Change the demo for reatlime cursor to use predefined names. * Fix the React Router auth block docs. * Regenerate the realtime chat code. * Add a docs field to the clients blocks. Add a missing package to the nextjs client block. * Add links to additional docs on the auth blocks pages. * Add additional links to the current user avatar docs. * Add additional links to the client docs. * Add additional links to the dropzone docs. * Add additional links to the avatar stack. * Add additional links to the realtime cursor. * Add additional links to the realtime chat. * Fix the dropzone links.
88 lines
2.8 KiB
Plaintext
88 lines
2.8 KiB
Plaintext
---
|
|
title: Dropzone (File Upload)
|
|
description: Displays a control for easier uploading of files directly to Supabase Storage
|
|
---
|
|
|
|
<ComponentPreview
|
|
name="dropzone-demo"
|
|
description="An alert with an icon, title and description. The title says 'Heads up!' and the description is 'You can add components to your app using the cli.'."
|
|
/>
|
|
|
|
## Installation
|
|
|
|
<BlockItem
|
|
name="dropzone-react"
|
|
description="Displays a control for easier uploading of files directly to Supabase Storage"
|
|
/>
|
|
|
|
## Folder structure
|
|
|
|
<RegistryBlock itemName="dropzone-react" />
|
|
|
|
## Introduction
|
|
|
|
Uploading files should be easy—this component handles the tricky parts for you.
|
|
|
|
The File Upload component makes it easy to add file uploads to your app, with built-in support for drag-and-drop, file type restrictions, image previews, and configurable limits on file size and number of files. All the essentials, ready to go.
|
|
|
|
**Features**
|
|
|
|
- Drag-and-drop support
|
|
- Multiple file uploads
|
|
- File size and count limits
|
|
- Image previews for supported file types
|
|
- MIME type restrictions
|
|
- Invalid file handling
|
|
- Success and error states with clear feedback
|
|
|
|
## Usage
|
|
|
|
- Simply add this `<Dropzone />` component to your page and it will handle the rest.
|
|
- For control over file upload, you can pass in a `props` object to the component.
|
|
|
|
```tsx
|
|
import {
|
|
Dropzone,
|
|
DropzoneContent,
|
|
DropzoneEmptyState,
|
|
} from '@/components/dropzone'
|
|
import { useSupabaseUpload } from '@/hooks/use-supabase-upload'
|
|
|
|
const FileUploadDemo = () => {
|
|
const props = useSupabaseUpload({
|
|
bucketName: 'test',
|
|
path: 'test',
|
|
allowedMimeTypes: ['image/*'],
|
|
maxFiles: 2,
|
|
maxFileSize: 1000 * 1000 * 10, // 10MB,
|
|
})
|
|
|
|
return (
|
|
<div className="w-[500px]">
|
|
<Dropzone {...props}>
|
|
<DropzoneEmptyState />
|
|
<DropzoneContent />
|
|
</Dropzone>
|
|
</div>
|
|
)
|
|
}
|
|
|
|
export FileUploadDemo
|
|
```
|
|
|
|
## Props
|
|
|
|
| Prop | Type | Default | Description |
|
|
| ------------------ | ---------- | ------- | ---------------------------------------------------- |
|
|
| `bucketName` | `string` | `null` | The name of the Supabase Storage bucket to upload to |
|
|
| `path` | `string` | `null` | The path or subfolder to upload the file to |
|
|
| `allowedMimeTypes` | `string[]` | `[]` | The MIME types to allow for upload |
|
|
| `maxFiles` | `number` | `1` | Maximum number of files to upload |
|
|
| `maxFileSize` | `number` | `1000` | Maximum file size in bytes |
|
|
|
|
## Further reading
|
|
|
|
- [Creating buckets](https://supabase.com/docs/guides/storage/buckets/creating-buckets)
|
|
- [Access control](https://supabase.com/docs/guides/storage/security/access-control)
|
|
- [Standard uploads](https://supabase.com/docs/guides/storage/uploads/standard-uploads)
|