Skip to content
Design System
GitHub

Attachment

v0.23.1Beta

One file in a list, a composer or a queue: type, name, size, progress, error with Retry, Download and Remove.

incident-7F3A.mcap86.0 MB
hall-b-map-v12.pgm
68 %
route.geojsonNot a valid GeoJSON file.
handover.pdf220 KB

Attachment states

Install
npx shadcn add @syncrobotic/attachment

Also installs: lucide-react, @syncrobotic/cn, @syncrobotic/file-type, @syncrobotic/file-upload, @syncrobotic/progress

Overview

A file row, chip or image tile showing a file's type, name, size and state.

When to use

  • Upload queues with progress.
  • Files attached to an incident or message.
  • Image strips with previews.

Use something else

More examples

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

door-3.jpg1.2 MBlidar-scan.pcd30 % · 24.0 MBnotes.txtUpload failed

Attachment chips

obstacle.jpg900 KB7F3A-log.mcap12.0 MB

Attachment in composer

gate-north.jpg
pallet-blocking.jpg
Too large

Attachment images

Attached to incident #2041
incident-2041.mcap86.0 MB
operator-report.pdf340 KB

Attachment read only

door-3-left.jpg
door-3-right.jpg
pallet.jpg
corridor-b4.jpg
badge-reader.jpg

Attachment gallery

taipei-warehouse-hall-b-night-patrol-2026-11-17-full-recording.mcap1.8 GB
taipei-warehouse-floor-plan-revision-12-final.pdf4.1 MB

Attachment long name

Usage rules

  • An error says why in words and offers Retry.
  • Remove is always the last action, and names the file for screen readers.

Changelog

  • 0.23.12026-11-21Removes a stale lint comment for a rule this kit does not use. No visible change.
  • 0.23.02026-11-20Every word it says can be translated without editing the source: labels (AttachmentLabels: "Upload failed", "Failed", the percentage, and the Retry, Download, Cancel, Remove and progress names).
  • 0.9.02026-11-17New.

How to upgrade