@useupup/preact
v3.3.5
Published
Preact file uploader with cloud-drive sources, resumable uploads, an image editor (real Filerobot as a lazy real-React island), theming, and ICU i18n.
Readme
@useupup/preact
Preact file uploader with cloud-drive sources (Google Drive, OneDrive, Dropbox,
Box), resumable uploads, theming, and ICU i18n. It is a preact/compat
re-export of @useupup/react — the
same UI and API, resolved against Preact.
Requires Preact 10.13+ (preact is a peer dependency; the image editor has
additional optional peers — see below).
Install
npm i @useupup/preactUsage (Client Mode)
Client Mode uploads directly from the browser to your storage; your server only
issues short-lived upload credentials at uploadEndpoint.
import { UpupUploader } from '@useupup/preact'
import '@useupup/preact/styles'
export function App() {
return (
<UpupUploader
provider="aws"
uploadEndpoint="/api/upload-token"
onFileUploadComplete={(file, key) =>
console.log('Uploaded', file.name, 'to', key)
}
/>
)
}uploadEndpoint is your own route returning a presigned upload URL — see the
quickstart for a ready-made handler.
Use it in a Preact project that has the standard preact/compat aliases
(react / react-dom → preact/compat) configured in its bundler, as with any
React-compatible library.
Server Mode
For credential isolation and server-proxied cloud drives, add
@useupup/server and point the
uploader at it — server mode works identically through the preact/compat
re-export:
<UpupUploader mode="server" serverUrl="/api/upup" provider="aws" />Image editor
The optional image editor runs as an isolated real-React island: it lazily
loads actual react / react-dom on demand to render Filerobot, so React never
enters your main Preact bundle. If you enable the editor, install its peers
(react, react-dom, react-filerobot-image-editor, and the konva /
react-konva / styled-components dependencies it needs — see this package's
peerDependencies).
Also exported
Because it re-exports @useupup/react, the public surface matches @useupup/react
exactly (UpupUploader, UpupThemeProvider, the brand icons, and the use*
hooks).
Links
License
MIT
