Uppy is an open source project by Transloadit
New: Transloadit Community Plan — get free hosted Companion & tusd, unlimited uploading, and 5GB/month encoding traffic!

Uppy 0.28: A look behind the scenes

Monday Nov 5, 2018

In 0.28, we are introducing a new “Single Upload” mode, improving on the Status Bar plugin with a spinner and different pause/resume/cancel buttons. We’ll also share some progress on bringing back unified locale packs and a Transloadit Preset 🍁

Single Uploads

Uppy has been flexible about uploading lots of things from the start. You can add files at any time, even after uploads have already started. This is neat, but not always the desired behaviour: sometimes, you just want to upload a few files together with a form. In that case, it’s useful to allow users to only upload a set of files once. 0.28.0 adds some options to help with that!

An upload in Uppy terminology can be more than one file. Users can add a bunch of files and when they press “Upload”, all those files are bunched up into an upload. They can then add more files and press the “Upload” button again: the new files are bunched into a second upload.

The new allowMultipleUploads option in Uppy Core can be set to false to only allow a single one of those uploads. Once an upload is started, the Dashboard and Status Bar no longer show “add files” and “upload” buttons. You can listen for a ‘complete’ event and then safely continue your app’s form flow.

The Dashboard also has a new option: closeAfterFinish. When true, the modal Dashboard will automatically hide once an upload has completed. You should only use this option in conjunction with allowMultipleUploads, otherwise it might close the Dashboard when the user isn’t done yet! It can only be used with the modal Dashboard, when inline is set to false. “Closing” an inline Dashboard makes no sense :smile: You will see a warning in the console in both cases, so you don’t have to remember all that.

Speaking of the Dashboard, it now also shows more statuses in the title bar: “Upload complete”, “Upload paused”, “Processing 5 files” and “Uploading 5 files”.

Status Bar improvements

  • ⚠️ breaking We’ve added separate options for hiding pause/resume and cancel buttons. So now there are several options for buttons: hideUploadButton, hideRetryButton, hidePauseResumeButton and hideCancelButton. These options can be passed from the Dashboard, if you are not using Status Bar separately (most common case). See the docs for more info: https://uppy.io/docs/status-bar/.
  • The Status Bar now features a spinner animation when upload is in progress.
  • Encoding (with the Transloadit plugin, for example) and uploading progress now get different colors, so it’s easier to tell what’s happening, visually.

Locale packs

In the beginning, we used to have unified locale packs for text strings in Uppy — English, Russian, German, Polish, etc. Then we made a switch to per-plugin locales, and the ability to load one file with locale strings in any language (locale pack) was lost for a while. This release is the first step in bringing this functionality back.

With this change, you can load a locale pack like so: const uppy = Uppy({locale: german}), then still override specific strings in a certain plugin, if needed:

const uppy = Uppy({locale: german})
uppy.use(Dashboard, {
  trigger: '#pick-files',
  locale: {
    strings: {
      dropPasteImport: 'Something else here, %{browse} or this'

The benefit to this is that there will be a central point of configuration for languages, so there could be language packs with strings for, e.g., Czech at @uppy/lang-cz (or @uppy/langs/cz) that would be very easy to contribute to (or use).

After Uppy 0.28.0, this functionality is technically possible, but we still need to update and publish locale packs for multiple languages.

Hosted Companion with Transloadit

When using remote providers such as Google Drive and Dropbox, so that your users can pick files from these sources, you can host Companion yourself, or use the one provided by Transloadit. And to simplify the latter, you can now use Transloadit.COMPANION and Transloadit.COMPANION_PATTERN constants in remote provider options:

const Dropbox = require('@uppy/dropbox')
const Transloadit = require('@uppy/transloadit')

uppy.use(Dropbox, {
  serverUrl: Transloadit.COMPANION
  serverPattern: Transloadit.COMPANION_PATTERN

Please see Transloadit plugin documentation for more details.

Transloadit Preset

Lately, we’ve been working on a wrapper package around Uppy and the Transloadit plugin that will make common Transloadit-based workflows much simpler to implement. It’s not ready just yet, but it should land in the next month!

This “preset” will provide three or so simple methods:

  • transloadit.form(), to enhance a form with existing file <input>s with Transloadit encoding capabilities, powered by Uppy’s resilient uploading plugins
  • transloadit.modal(), to show a one-off modal Dashboard that uploads to Transloadit’s encoding backend
  • transloadit.upload(), to instruct Uppy to upload files, using your own UI instead

Stay tuned!

Other Cool Changes

  • @uppy/core: ⚠️ breaking remove upload-cancel event, file-removed should be enough, see #1069 for details
  • @uppy/companion: ⚠️ breaking Migrated provider adapter to Companion: saves 5KB on the frontend, all heavy lifting moved to the server side
  • @uppy/companion: Removed an erroneous TypeScript dependency that added 40MB to the install size
  • @uppy/thumbnail-generator: You can now constrain thumbnail height, thanks to @richartkeil, see #1096 for documentation (we are planning to add real Thumbnail Generator documentation soon, too!)
  • @uppy/webcam: Fix getting data from Webcam recording if mime type includes codec metadata (#1094 / @goto-bus-stop)
  • meta: Added integration tests (in real browsers, thanks to Sauce Labs) for @uppy/url, @uppy/transloadit and @uppy/thumbnail-generator 🚀

See full changelog (0.28 and 0.27.x patches) for more

See you in the next release!

The Uppy Team