BlockDex

Components

Registries

Free blocks

Method

BlockDex

Components

Registries

Free blocks

Method

Open API

BlockDex

Components

Registries

Free blocks

Method

Open API

Components/files-sdk/multipart-uploader

Multipart Uploader

files-sdk/multipart-uploader
FreeComponent

Multi-file queue uploader with bounded concurrency, live progress and cancel.

Install it

npx shadcn@latest add https://files-sdk.dev/r/multipart-uploader.json

Source

registry/files-sdk/multipart-uploader/multipart-uploader.tsxfiles-sdk.dev/r/multipart-uploader.json · first 6 KB
1"use client";
2
3import type { UseFilesResult } from "files-sdk/react";
4import { FileIcon, Loader2Icon, UploadIcon, XIcon } from "lucide-react";
5import { useCallback, useRef, useState } from "react";
6
7import { Button } from "@/components/ui/button";
8import { Progress } from "@/components/ui/progress";
9import { cn } from "@/lib/utils";
10
11type QueueStatus = "pending" | "uploading" | "success" | "error";
12
13interface QueueItem {
14 id: number;
15 file: File;
16 status: QueueStatus;
17 /** 0–1. */
18 progress: number;
19 key?: string;
20 error?: string;
21}
22
23export interface MultipartUploaderProps {
24 /** A `useFiles()` instance — uploads through it. */
25 files: UseFilesResult;
26 /** Key prefix (folder) for explicit keys, e.g. `"docs/"`. Empty = server mints keys. */
27 prefix?: string;
28 /** `accept` attribute for the file input. */
29 accept?: string;
30 /** Parallel uploads. Default 3. */
31 concurrency?: number;
32 onUploaded?: (entry: { key: string; name: string }) => void;
33 className?: string;
34}
35
36/**
37 * Multi-file queue uploader. Files upload with bounded concurrency and live
38 * per-file progress; large files are chunked into a multipart upload by the
39 * gateway transparently. Cancel aborts everything in flight.
40 */
41export const MultipartUploader = ({
42 files,
43 prefix = "",
44 accept,
45 concurrency = 3,
46 onUploaded,
47 className,
48}: MultipartUploaderProps) => {
49 const idRef = useRef(0);
50 const inputRef = useRef<HTMLInputElement>(null);
51 const [queue, setQueue] = useState<QueueItem[]>([]);
52 const [isUploading, setIsUploading] = useState(false);
53
54 const patch = useCallback((id: number, next: Partial<QueueItem>) => {
55 setQueue((prev) =>
56 prev.map((item) => (item.id === id ? { ...item, ...next } : item))
57 );
58 }, []);
59
60 const add = useCallback((list: FileList | null) => {
61 if (!list?.length) {
62 return;
63 }
64 const additions: QueueItem[] = [...list].map((file) => {
65 const id = idRef.current;
66 idRef.current += 1;
67 return { file, id, progress: 0, status: "pending" };
68 });
69 setQueue((prev) => [...prev, ...additions]);
70 }, []);
71
72 const start = useCallback(async () => {
73 const pending = queue.filter((item) => item.status === "pending");
74 if (!pending.length) {
75 return;
76 }
77 // Re-arm the hook in case a previous run was cancelled (aborted) controller.
78 files.reset();
79 setIsUploading(true);
80
81 let cursor = 0;
82 const worker = async () => {
83 while (cursor < pending.length) {
84// … truncated

What it pulls in

npm packages

  • files-sdk
  • lucide-react

Other registry items

  • button
  • progress

Files it writes

  • registry/files-sdk/multipart-uploader/multipart-uploader.tsx

Facts

Registry
files-sdk
Type
registry:component
Access
Free
Files written
1
Licence
MIT
First indexed
2026-08-03
Last confirmed
today

Go to the source

files-sdk.dev haydenbleasel/files-sdk on GitHub Raw registry item This item as JSON

More from files-sdk

All 12 items
Same registry, same kind — the ones you would have found next
ComponentRegistryKindAccessInstallsCommand
Capabilities Badgescapabilities-badgesfiles-sdkComponentsFree2 deps
Dropzonedropzonefiles-sdkComponentsFree2 deps
File Actionsfile-actionsfiles-sdkComponentsFree2 deps
File Browserfile-browserfiles-sdkComponentsFree2 deps
File Listfile-listfiles-sdkComponentsFree2 deps
File Previewfile-previewfiles-sdkComponentsFree2 deps
File Searchfile-searchfiles-sdkComponentsFree2 deps
Share Dialogshare-dialogfiles-sdkComponentsFree2 deps
BlockDex

Built by

Kynth Studio

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

BlockDex

BlockDex

Built by

Kynth Studio

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

BlockDex

BlockDex

Built by

Kynth Studio

Index

Components
Registries
Method
Open API

Guides

shadcn component libraries
Best shadcn registries
Free shadcn blocks

Reference

Corpus counts
Crawl health
hello@kynth.studio
Privacy
Terms

BlockDex