Skip to content
Design System
GitHub

File upload

v0.10.1Beta

A drop zone that is also a button: checks type, size and count, and says what it refused.

Drop files here or choose filesAny file up to 50 MB

File upload default

Install
npx shadcn add @syncrobotic/file-upload

Also installs: lucide-react, @syncrobotic/cn

Overview

An area that takes files by drop or by the picker, validates them, and hands the accepted ones to you.

When to use

  • Maps, logs and recordings uploaded to a site.
  • A single photo or avatar.
  • A compact attach row in a form.

Use something else

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

Drop a site map.pgm with its .yaml, or a .pcd point cloud, up to 200 MB

File upload maps

Attach a log.bag or .mcap

File upload compact

Site photo

File upload single image

Add camera clipsMP4 or MOV, up to 2 GB each
north-gate-0214.mp4182.0 MB
hall-b-0215.mp4
42 %
dock-0216.movOver 2 GB. Trim it or split it.

File upload queue

Uploads are pausedStorage is full (512.0 GB)

File upload disabled

Upload robot photo
Robot photoSquare, at least 256 px

File upload avatar

Add up to 3 files0 of 3

File upload max files

Drop maps here.pgm and .yaml
hall-b-map-v13.pgm
64 %

File upload with progress

Evidence
Attach photos or logsUp to 20 MB each

File upload in form

Drop a robot log.mcap, .bag (ROS 1) or .db3 (ROS 2), up to 2.0 GB

File upload formats

Drop a site map.pgm with its .yaml, up to 200 MB
  • floor-plan.pdf is not a supported type.
  • full-scan.pgm is too large (412 MB, limit 200 MB).

File upload rejected

Usage rules

  • Say what is accepted and how big, in the hint.
  • Report refused files by name and reason.
  • Show what was taken as Attachment rows.

Changelog

  • 0.10.12026-11-21With multiple off, extra files are refused as "count" through onReject instead of dropped silently; other attributes such as aria-label reach the drop zone (an icon-only zone has a name).
  • 0.10.02026-11-18Disabled keeps its words readable: a grey field (bg-muted, muted text) on controls with a surface, solid disabled ink on items and icons; no more 50 % opacity, which washes text out in sunlight.
  • 0.9.02026-11-17New.

How to upgrade