File Upload — Drag and Drop

Drag-and-drop file picker with browse fallback, size validation, and a removable selected-files list.

Forms · React · Subscription · commercial licence · v1.0.0 · updated 2026-10-15 · Live demo

Install

velocityx add file-upload-dropzone

Subscription component. Run velocityx login with your key first — get one.

---
import FileUploadDropzone from '../components/velocity/file-upload-dropzone/FileUploadDropzone.jsx';
---
<FileUploadDropzone client:visible />

Props

Prop	Type	Default	Description
label	string	'Upload files'	—
helpText	string	'PDF, PNG or JPG, up to 10MB each.'	—
accept	string	'.pdf,.png,.jpg,.jpeg'	—
maxSizeMb	number	10	—
multiple	boolean	true	—
onFilesChange	—	—	—

Files written

velocityx drops these into your project:

• components/velocity/file-upload-dropzone/FileUploadDropzone.jsx

Peer dependencies

react, react-dom — nothing else. Zero external dependencies is the point.

Theming

Colours come from the primary-* / accent-* Tailwind scales, so this drops into a project that is not Velocity without dragging our brand in. Install the contract once:

velocityx theme

Then set your whole brand in one place — raw RGB channels, not hex (a hex here silently breaks every opacity variant):

:root {
  --vx-brand: custom;
  --vx-primary-600: 220 38 38;
}

There is no component-level font-family anywhere in the library — your font cascade wins.

Licence

Commercial, for the duration of an active Velocity X subscription. The source is served by the licence-gated endpoint, never by the public CDN.