import { FileUpload } from "@elabs-ai/components-ui";npm install @elabs-ai/components-tokens @elabs-ai/components-uiPrompt for your coding agent
Paste it into Claude Code, Cursor, Codex or any other coding agent. Text in [brackets] is yours to fill in.
Add the brand-ui FileUpload component (from @elabs-ai/components-ui) to this project. 1. Read https://elabs-ai.com/llms.txt first: it maps every package and the rules. If you can use MCP servers, connect https://elabs-ai.com/mcp and use its search, docs and tokens tools. If not, run the same lookups in the terminal: `npx -y @elabs-ai/components-cli search "<what you need>"` and `npx -y @elabs-ai/components-cli docs <Component>`. 2. Look FileUpload up before writing code: `npx -y @elabs-ai/components-cli docs FileUpload` prints its real props, variants, what it pairs with and what to avoid. 3. If @elabs-ai/components-ui is not installed yet: `pnpm add @elabs-ai/components-tokens @elabs-ai/components-ui` (or `npm install @elabs-ai/components-tokens @elabs-ai/components-ui`). If this is the first brand-ui package in the project, wire it once: import `@elabs-ai/components-tokens/styles.css` plus the `themes/light.css` and `themes/dark.css` stylesheets in the CSS entry, add one Tailwind `@source` line per installed @elabs-ai package (Tailwind does not scan node_modules, so without it everything renders unstyled), and wrap the app root in `ThemeProvider` from `@elabs-ai/components-tokens`. 4. Use it here: [the screen or file, and what it should show] 5. Rules: use only @elabs-ai/components-* components and the semantic tokens — no raw colours, no raw font sizes, no arbitrary Tailwind values. Look up each component's real props with the docs tool before you use it; never guess a prop. 6. Done means: the typecheck passes, `npx -y @elabs-ai/components-cli audit src --strict` reports nothing, and you have opened the app and looked at every screen you touched in the light and the dark theme.
Examples
Uncontrolled
Controlled
With Progress
With Error
Disabled
API
FileUpload
| Prop | Type | Description |
|---|---|---|
files | UploadFile[] | Controlled file list. |
onFilesChange | (files: UploadFile[]) => void | Called when files are added or removed. |
onFilesRejected | (rejections: FileRejection[]) => void | Called with the files a picker selection OR a drag-and-drop declined — wrong type (`accept`), over `maxSize`, over `maxFiles`, or extra files dropped when `multiple` is false — each with its {@link FileRejectionReason}. |
accept | string | Accepted MIME types / extensions (forwarded to <input accept>). |
multiple | boolean | Allow multiple files at once. |
maxSize | number | Maximum individual file size in bytes. |
maxFiles | number | Maximum number of files in the list at once. |
disabled | boolean | Disable all interactions. |
children | ReactNode |
FileUploadDropzone
| Prop | Type | Description |
|---|---|---|
browseLabel | string | Label for the default "Browse files" button. |
FileUploadItem
| Prop | Type | Description |
|---|---|---|
uploadFilerequired | UploadFile | The UploadFile entry to display. |
progress | number | Upload progress 0–100. Shown only during "uploading" status. |
status | FileUploadStatus | Current status of the upload. |
errorMessage | string | Error message (displayed when status="error"). |