# @uppy/progress-bar

> A progress bar UI for Uppy

Latest version **4.3.2** (published 2025-08-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install @uppy/progress-bar
pnpm add @uppy/progress-bar
yarn add @uppy/progress-bar
bun add @uppy/progress-bar
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities; high maintenance score; popular repo.

Warnings: low downloads; no types.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 4.3.2 |
| Published | 2025-08-01 |
| First published | 2018-06-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 16.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30989 |
| Maintainers | kvz, tim-kos, murderlon, mifi, uppydev |
| Keywords | file uploader, uppy, uppy-plugin, progress, progress bar, upload progress |

## Links

- npm: https://www.npmjs.com/package/@uppy/progress-bar
- Repository: https://github.com/transloadit/uppy
- Homepage: https://uppy.io
- Issues: https://github.com/transloadit/uppy/issues
- npm.io page: https://npm.io/package/@uppy/progress-bar

## Dependencies (2)

- [preact](https://npm.io/package/preact.md) ^10.5.13
- [@uppy/utils](https://npm.io/package/@uppy/utils.md) ^6.2.2

## Recent versions

- 4.3.2 (latest) — 2025-08-01
- 4.0.0-beta.4 (next) — 2024-05-03
- 4.3.1 — 2025-07-29
- 4.3.0 — 2025-07-29
- 4.2.1 — 2025-01-09
- 4.2.0 — 2025-01-06
- 4.1.0 — 2024-12-17
- 4.0.2 — 2024-12-05
- 4.0.1 — 2024-10-31
- 4.0.0 — 2024-07-10
- 4.0.0-beta.3 — 2024-04-15
- 4.0.0-beta.2 — 2024-04-11
- 4.0.0-beta.1 — 2024-03-28
- 3.1.1 — 2024-03-27
- 3.1.0 — 2024-02-28
- … 68 more at https://npm.io/package/@uppy/progress-bar/versions

## README

# @uppy/progress-bar

<img src="https://uppy.io/img/logo.svg" width="120" alt="Uppy logo: a smiling puppy above a pink upwards arrow" align="right">

[![npm version](https://img.shields.io/npm/v/@uppy/progress-bar.svg?style=flat-square)](https://www.npmjs.com/package/@uppy/progress-bar)
![CI status for Uppy tests](https://github.com/transloadit/uppy/workflows/CI/badge.svg)
![CI status for Companion tests](https://github.com/transloadit/uppy/workflows/Companion/badge.svg)
![CI status for browser tests](https://github.com/transloadit/uppy/workflows/End-to-end%20tests/badge.svg)

ProgressBar is a minimalist plugin that shows the current upload progress in a
thin bar element. Like the ones used by YouTube and GitHub when navigating
between pages.

Uppy is being developed by the folks at [Transloadit](https://transloadit.com),
a versatile file encoding service.

## Example

```js
import Uppy from '@uppy/core'
import ProgressBar from '@uppy/progress-bar'

const uppy = new Uppy()
uppy.use(ProgressBar, {
  // Options
})
```

## Installation

```bash
$ npm install @uppy/progress-bar
```

Alternatively, you can also use this plugin in a pre-built bundle from
Transloadit’s CDN: Smart CDN. In that case `Uppy` will attach itself to the
global `window.Uppy` object. See the
[main Uppy documentation](https://uppy.io/docs/#Installation) for instructions.

## Documentation

Documentation for this plugin can be found on the
[Uppy website](https://uppy.io/docs/progress-bar).

## License

[The MIT License](./LICENSE).

---
_Source: https://npm.io/package/@uppy/progress-bar · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._