File Uploader (Dropzone)
FormDrag-and-drop file upload area built with react-dropzone. Supports file type and size validation.
Responsive viewport — resize the window to explore. Direction and density apply only to this preview. Theme applies to the docs too.
"use client";
import {
FileUpload,
FileUploadList,
} from "@dashboardpack/core/components/ui/file-upload";
import { useState } from "react";
export default function FileUploadExample() {
const [files, setFiles] = useState<File[]>([]);
return (
<div className="w-full max-w-md space-y-3">
<FileUpload
value={files}
onValueChange={setFiles}
accept={{ "image/png": [".png"], "image/jpeg": [".jpg", ".jpeg"] }}
maxFiles={3}
maxSize={5 * 1024 * 1024}
>
<FileUploadList />
</FileUpload>
<p className="text-xs text-muted-foreground">
PNG or JPEG, up to 5 MB each. Files stay in this preview; no upload is
performed.
</p>
</div>
);
}Usage
Compose FileUploadList inside FileUpload. accept, maxSize, and maxFiles configure local file selection. This component does not send files to a server or expose a rejection callback.
import {
FileUpload,
FileUploadList,
} from "@dashboardpack/core/components/ui/file-upload";Available in the included @dashboardpack/core package. Copy the complete example from Source code for all imports and state. Add "use client" when using hooks or event handlers. See installation and theming for project setup.
API reference
Common props and defaults. Slot-specific props are named below; native elements also accept their standard HTML attributes. The component TypeScript definitions are the complete type reference.
| Prop | Type / Default | Description |
|---|---|---|
| value / onValueChange | File[] / (files: File[]) => voidDefault: internal state | Optional controlled selected files. |
| accept | DropzoneOptions["accept"]Default: — | MIME types mapped to extensions. |
| maxSize | numberDefault: — | Maximum bytes per file. |
| maxFiles | numberDefault: — | Maximum selected files. |
| disabled | booleanDefault: false | Disable file selection. |
| children | ReactNodeDefault: required | Place FileUploadList or custom content here. |