File Drop Zone
A dashed drop target that lights up on drag-over, takes real drops or a browse click, then uploads with honest progress and a clean done state. Client-side only — no server needed for the demo.
What you should hear: Tab reaches the control, Enter or Space activates it — and every state change is announced in the same words the page shows.
Ambience is a live light wash over the preview. Full palette re-theming of every demo arrives with Theme Studio (Pro).
// File Drop Zone — the demo's own source, extracted verbatim.
// From src/components/demos/scenes/set-03.tsx, export FileDropZone.
// Needs React 18+ and Tailwind CSS v4. The classes below include this site's
// token utilities (bg-panel, text-ink-dim, chip …); their values are served as
// CSS custom properties at /api/exports/tokens.json. The reduced-motion branch
// is part of the source, not an afterthought.
// 3 helpers the demo imports are inlined above it, verbatim.
import { useEffect, useRef, useState } from "react";
export interface SceneMotion {
/** True when the reader asked the system for less motion. */
reduced: boolean;
/** A duration in milliseconds, collapsed to 0 when reduced. */
ms: (value: number) => number;
/** A repeat count, collapsed to 1 when reduced — an entrance plays once. */
times: (value: number) => number;
}
export function useReducedMotion(): boolean {
const [reduced, setReduced] = useState<boolean>(() =>
typeof window !== "undefined" ? window.matchMedia("(prefers-reduced-motion: reduce)").matches : false
);
useEffect(() => {
const mq = window.matchMedia("(prefers-reduced-motion: reduce)");
const on = (e: MediaQueryListEvent) => setReduced(e.matches);
mq.addEventListener("change", on);
return () => mq.removeEventListener("change", on);
}, []);
return reduced;
}
export function useSceneMotion(): SceneMotion {
const reduced = useReducedMotion();
return {
reduced,
ms: (value: number) => (reduced ? 0 : value),
times: (value: number) => (reduced ? 1 : value),
};
}
export function FileDropZone() {
const [phase, setPhase] = useState<"idle" | "over" | "busy" | "done">("idle");
const [file, setFile] = useState<{ name: string; size: string } | null>(null);
const [pct, setPct] = useState(0);
const inputRef = useRef<HTMLInputElement>(null);
const started = useRef(false);
// #26 — the upload progress bar advances on a 90ms interval. Reduced: the
// bar goes to done in one step, because the crawl is the animation.
const { reduced } = useSceneMotion();
useEffect(() => {
// Reduced motion never reaches "busy": `accept` decides that, so this effect
// only ever runs for the animated path.
if (phase !== "busy" || reduced) return;
started.current = true;
const t = setInterval(() => {
setPct((p) => {
const n = p + 7 + Math.round(Math.random() * 6);
if (n >= 100) {
clearInterval(t);
setTimeout(() => setPhase("done"), 250);
return 100;
}
return n;
});
}, 90);
return () => clearInterval(t);
}, [phase, reduced]);
const accept = (f?: File | null) => {
const name = f?.name ?? "motif-build-spec.json";
const size = f ? `${(f.size / 1024 / 1024).toFixed(1)} MB` : "1.2 MB";
setFile({ name, size });
setPct(0);
// #26 — the crawl is the animation, so under reduced motion the upload is
// simply complete: decided here, where the work starts, rather than by an
// effect correcting the state a frame later.
setPhase(reduced ? "done" : "busy");
if (reduced) setPct(100);
};
const reset = () => { setPhase("idle"); setFile(null); setPct(0); started.current = false; };
return (
<div className="flex h-full w-full flex-col items-center justify-center bg-[radial-gradient(60%_90%_at_50%_0%,rgba(52,211,153,0.12),transparent_60%),#08090f] px-6">
<div className="w-full max-w-sm">
<input ref={inputRef} type="file" className="hidden" aria-hidden tabIndex={-1} onChange={(e) => accept(e.target.files?.[0])} />
<div
role="button"
tabIndex={0}
aria-label="Upload a build spec"
onDragOver={(e) => { e.preventDefault(); if (phase === "idle") setPhase("over"); }}
onDragLeave={() => phase === "over" && setPhase("idle")}
onDrop={(e) => { e.preventDefault(); accept(e.dataTransfer?.files?.[0]); }}
onClick={() => phase === "idle" && inputRef.current?.click()}
onKeyDown={(e) => { if ((e.key === "Enter" || e.key === " ") && phase === "idle") inputRef.current?.click(); }}
className={`flex cursor-pointer flex-col items-center justify-center gap-2 rounded-2xl border-2 border-dashed px-6 py-9 text-center outline-none focus-visible:outline focus-visible:outline-2 focus-visible:outline-mint transition-all duration-200 ${
phase === "over"
? "border-mint/70 bg-mint/8 scale-[1.01]"
: phase === "done"
? "border-mint/40 bg-mint/5"
: "border-white/15 bg-white/3 hover:border-mint/40 hover:bg-white/5"
}`}
>
{phase !== "done" ? (
<>
<span className="flex h-11 w-11 items-center justify-center rounded-2xl border border-white/12 bg-white/6 text-xl text-mint">⇪</span>
<span className="text-sm font-bold">{phase === "over" ? "Drop it — we have it" : "Drag a build spec here"}</span>
<span className="text-[11px] text-ink-faint">or <span className="font-semibold text-mint">browse files</span> · anything under 5 MB</span>
</>
) : (
<>
<span className="flex h-11 w-11 items-center justify-center rounded-full bg-mint/15 text-xl text-mint">✓</span>
<span className="text-sm font-bold text-mint">{file?.name}</span>
<span className="text-[11px] text-ink-faint">{file?.size} · uploaded clean</span>
</>
)}
</div>
{phase === "busy" && (
<div className="mt-3 rounded-xl border border-white/8 bg-black/25 p-3" style={{ animation: "mf-growin .15s ease-out both" }}>
<div className="flex items-center justify-between text-[11px]">
<span className="truncate font-semibold text-ink-dim">{file?.name}</span>
<span className="font-mono text-mint">{pct}%</span>
</div>
<div className="mt-1.5 h-1.5 overflow-hidden rounded-full bg-white/8">
<div className="h-full rounded-full bg-gradient-to-r from-mint to-cyan-300 transition-[width] duration-100" style={{ width: `${pct}%` }} />
</div>
<p className="mt-1.5 text-[10px] text-ink-faint">auditing a11y + size before it lands in your stack…</p>
</div>
)}
{phase === "done" && (
<button type="button" onClick={reset} className="btn btn-ghost mt-3 !w-full !py-2 text-xs">
↺ Upload another
</button>
)}
</div>
</div>
);
}
Snippet provenance
lines 1–137 · v1.0.0No changelog entry mentions “File Drop Zone”, so the catalog records a single version for it.
Every line above is attributed to the single version this catalog records — we keep no per-line history, so no per-line attribution is invented. See the provenance page for the rule and the gaps.
Review notes · anchored to code lines
Threads attach to a line number in this asset's snippet, so a remark about the focus trap stays next to it.
Loading notes…
The snippet on this page is 137 lines long, so anchors run 1–137. Notes are per-asset and per-browser; a shared review thread is a server feature, and this panel is the local stand-in that proves the anchoring works.
Why it works — A bare file input is the ugliest control on the web; a drop zone turns upload into a spatial action and previews the consequence.
The idea — The drag-over state must be unmistakable — border colour, tint and a 1% scale lift — because drop targets only work when users trust they're aimed right.
When to skip it — Keep the browse fallback always visible: drag-and-drop is a discovery, not a requirement — some people are on touch or in files-first workflows.
Course rail — understand it before you ship it
Live variants
Variant gallery
The same File Drop Zone demo re-lit in three tones — no code change, three personalities.
Theme Studio preview
Theming example — two token themes
Assets are token-driven (100% design-token driven). Here the same scene runs under two theme presets from the token sheet.
--accent 262 · dark surfaces
--accent 40 · paper surfaces
90-second read
Usage recipe — where this fits
Put it where a micro-decision happens: a toggle, a loader, a hover state — the small moments that make an interface feel considered.
Drop it into the exact spot it belongs, keep the default props until the copy is final, then tune the one knob that matters for your context.
Cost honesty
Performance note
Cheaper alternative — if you need even lighter, the plain HTML version skips React entirely — same result, ~0 KB.
What it needs
Browser support strip
No polyfills ship with the asset — if a listed feature is missing in a target browser, the graceful fallback is the static layout.
prefers-reduced-motion
Reduced-motion fallback
With prefers-reduced-motion: reduce, the animation loop and travel are removed; state changes keep working through opacity and colour (≤ 300ms). The demo you see above honours the switch — try it in your OS settings and the loop will quiet down.
Design rule: the reduced branch is a second design, not a stripped page — every state change stays visible.
Pressable step-through
Keyboard walk demo
Step through what a keyboard user experiences with this asset.
Tab to the element — the focus ring is visible before interaction
Auto-suggested
Composition map — what pairs well
Same-family assets that compose cleanly with this one:
Prism Switch
A theme-aware toggle that sweeps a six-stop prism gradient across the track on every flip. Pure CSS states, keyboard reachable, announces state to screen readers.
ElementsHalo Button
Primary button with a mouse-tracking halo, press ripple and a springy scale. Ships as React + Tailwind or dependency-free HTML/CSS.
ElementsPulse Loader
Three-note loader with staggered radial pulse and optional progress text. Reduced-motion safe and tiny — 0.8 KB gzipped.
One original micro-case
Inspiration context
The settings row that got fewer support tickets
A settings screen had seventeen identical switches with no press state. Users could not tell whether a tap had registered, so they tapped twice — and support logs filled with 'it toggles back'. The fix was one press-state scale plus a 250ms state fade per row. Ticket volume on that screen dropped by half in a month.
Written in-house — no screenshots, no borrowed imagery. The pattern, not the pixels.
Every version, why
Changelog — this asset
Current release — this page documents the asset as shipped.
Token pass: colours and radii moved to the design-token sheet; a11y score raised to the current bar.
Initial release to the library — original markup, MIT licensed.
30-day sparkline
Copy history
Sample series from this asset's usage fingerprint · last 12 days shown.
Future queue
Community remixes
Queue opens after launch. Remixes arrive as alternate versions of this asset — same job, different voice — submitted by users and audited by the studio before they appear beside the original.
Star / favourite
Save this asset
Your collection is stored in this browser (localStorage) — no account needed.
Build a page around it
Pairs well with a prompt
This asset belongs inside a bigger build — here is the prompt that would generate a page containing it:
A11y-strict page — WCAG AA as a hard requirement
AA requirements · Contrast audit · Keyboard map
Exact tree
Bundled dependencies — disclosed
Full snippet ≈ 6.7 KB raw, ~1 KB gzip — before any framework you already load.
Download
Export as single file
Grab the asset as one file, ready to paste into your project.
Files are generated in your browser from the snippets on this page — nothing leaves the tab.
Scale, not clutter
Sizing system — three densities
Density is a token decision, not a per-page override — pick one density per product surface and hold it. Active: Default.
Runnable copy
Open in a sandbox
Opens this asset in a new tab with its stylesheet injected — a real, editable HTML document in your browser. No account, no upload.
If the tab is blocked, use the single-file export instead — same content, saved locally.
Written version first
Tutorial transcript
This asset does not have a video yet — so the written version stands in: the code line walk below narrates the snippet line by line, and the design rationale on this page explains the default decisions. When a video ships, this exact panel hosts its full transcript.
Annotated snippet
Code line walk
The lines that matter, with the reason they matter. Click one:
Trade-off, visible
Size vs. quality slider
Standard · CSS + hover states
~6 KBadds transitions, focus-visible and reduced-motion rules
The slider is honest: the slim tier has no JS, the pro tier pays for behaviour. Start slim, upgrade only the surfaces that need it.
HTML → React, priced
Stack-switch cost note
Taking the HTML/CSS version into a React component costs real work — and the cost is predictable:
Event wiring
Hover, focus and click become handlers — the CSS stays, the state appears.
Props for the knobs
Every inline value that should vary becomes a prop with a default — the defaults must match the CSS exactly.
The estimate
A clean port of this asset is 20–45 minutes for a React developer — the 287-character stylesheet is the easy half.
Find it the way you say it
Tag synonyms
Search on this site resolves synonyms globally — "dropdown", "select" and "picker" land on the same asset, so you never need to know the catalog's internal vocabulary.
When to pick which
Sibling comparison
| Compare | File Drop Zone | Prism Switch | Halo Button |
|---|---|---|---|
| Kind | Elements | Elements | Elements |
| Bundle | 2.6 KB gzip | 1.2 KB gzip | 2.1 KB gzip |
| a11y | 95/100 | 98/100 | 96/100 |
| Dependencies | none | none | none |
| Copies / mo | 610 | 4,820 | 3,910 |
| Interactions | drag, click, keyboard | click, hover | hover, click, drag |
The honest verdict — Prism Switch is lighter, but File Drop Zone carries richer behaviour — pick by the interaction your screen actually needs, then swap tokens, not pages.
Similar to this — scored on shared tags, not hand-picked
Related assets
Prism Switch
1.2 KB · a11y 98 · Q 96
Halo Button
2.1 KB · a11y 96 · Q 94
Pulse Loader
0.8 KB · a11y 99 · Q 93
Read next — two guides and a prompt
picked by tag overlap, not by handGuide
A form is a conversation
8 min · Beginner · updated 2026-09-12
Guide
Before you copy that component: the a11y checklist
8 min · Beginner · updated 2026-09-06
Prompt
3D portfolio with neon orbit showcase
Portfolio · 87% fidelity
How these three were chosen: essays scored on shared tags (0 and 0 matches), then prompt scored on block/vibe overlap (0 matches). The rule lives in src/lib/spine.ts, so the same asset always links to the same three pages and a second reader can reproduce the choice.
The counter is a note to yourself — it adds one each time you tap, in motif:remix-count:v1, and goes nowhere. A real, public remix count would need a server and accounts; this site has neither, and it would rather say that than print a number it cannot own.