File Upload

A drag-and-drop file upload area with per-file progress tracking, validation, cancel, and retry.

Installation

dotnet add package Lumeo

One-time app setup (AddLumeo(), CSS & JS) is covered in the installation guide.

@using Lumeo

<FileUpload />

Default

Click to upload or drag and drop

Image Upload

Upload an image

PNG, JPG or GIF up to 10MB

Multiple Files

Upload documents

Select one or more files

Upload with progress (fake delay)

Upload files

Each file uploads with simulated progress

Manual upload trigger (AutoUpload=false)

Choose files, then click Upload

Immediate upload (ShowFileList=false + Reset)

Pick a file — it uploads immediately, no card shown

With Progress (legacy)

Upload Images

PNG, JPG up to 10MB

Variant — interactive preview

Switch between Dropzone, Button, and Avatar to see the upload surface change.

Upload file

PNG, JPG or PDF up to 10MB

Method	Returns	Description
Reset()	Task	Clears internal file selection and upload state. Cancels any in-flight uploads. Remounts the native file input so the same file can be re-picked without a DOM workaround. Does not fire any events.
StartUploadAsync()	Task	Starts uploads for all pending items when `AutoUpload=false`.

Represents the state of each file in the upload queue. Passed to OnUpload, OnFileUploaded, OnFileFailed, etc.

Property	Type	Description
Id	string	Unique identifier (Guid hex) for this upload item.
File	IBrowserFile	The underlying browser file reference.
Name	string	File name.
Size	long	File size in bytes.
Status	FileUploadStatus	Current status: `Pending`, `Uploading`, `Succeeded`, `Failed`, `Cancelled`.
ProgressPercent	int	Upload progress 0–100, updated via IProgress.
ErrorMessage	string?	Error message if Status is Failed.
Url	string?	Server-returned URL or id after a successful upload.
ChunkSize	long	Chunk-size hint from the `ChunkSize` parameter (0 if not set).