# Upload progress toast

> A toast with a progress bar and percentage that fills up while files upload, then confirms and slips away.

- Category: [Toasts](https://library.aimran.es/components/toasts)
- Built with: HTML + CSS
- Live editor: https://library.aimran.es/blocks/uv-toast-progress
- Library: AIMRAN Library (https://library.aimran.es), free, no sign-up, by Aimran Oukham

## Where to use it

Uploads take time, and people want to keep working instead of staring at a spinner. Picture a photographer sending a wedding gallery to a client portal, or a landlord adding photos to a rental listing: the progress toast sits in a corner, counting up to 100% and switching to “Upload complete” at the end.

The demo fakes the progress with a timer, so link it to your real upload events. If you do not know the total size, a percentage will lie; use an indeterminate bar instead. For a single small file, a plain success message is enough.

## Code

### HTML

```html
<div class="uv-zp"><button class="fire">Start upload</button><div class="toast"><div class="copy"><b>Uploading files</b><small>Preparing…</small><i><em></em></i></div><strong>0%</strong></div></div>
```

### CSS

```css
.uv-zp {
  --c1: #0071e3;
  --c2: #8ec5ff;
  --s: 16px;
  /* tamaño */
  --k: 1;
  /* velocidad */
  --fg: #1d1d1f;
  /* texto */
  --bg: #f5f5f7;
  /* fondo */
}

.uv-zp {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  position: relative;
  width: 20em;
  height: 14em;
  font-size: var(--s);
}

.uv-zp>.fire {
  position: absolute;
  left: 50%;
  top: 50%;
  translate: -50% -50%;
  padding: .8em 1.25em;
  border: 0;
  border-radius: 999px;
  font: inherit;
  font-weight: 600;
  color: #fff;
  background: var(--c1);
  cursor: pointer;
  transition: transform calc(0.25s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-zp .toast {
  position: absolute;
  z-index: 2;
  left: 50%;
  bottom: .5em;
  display: flex;
  align-items: center;
  gap: .75em;
  width: 18em;
  padding: .85em;
  border-radius: 1em;
  color: var(--fg);
  background: var(--bg);
  box-shadow: inset 0 0 0 1px color-mix(in srgb,var(--fg) 10%,transparent),0 18px 45px rgba(0,0,0,.18);
  opacity: 0;
  pointer-events: none;
  transform: translate(-50%,2em);
}

.uv-zp .copy {
  display: grid;
  gap: .25em;
  flex: 1;
}

.uv-zp small {
  opacity: .5;
}

.uv-zp .copy>i {
  height: 4px;
  overflow: hidden;
  border-radius: 9px;
  background: color-mix(in srgb,var(--fg) 10%,transparent);
}

.uv-zp em {
  display: block;
  width: var(--p,0%);
  height: 100%;
  border-radius: inherit;
  background: linear-gradient(90deg,var(--c1),var(--c2));
  transition: width .18s cubic-bezier(.25,.1,.25,1);
}

.uv-zp strong {
  font-size: .75em;
  color: var(--c1);
}

.uv-zp .toast.show {
  opacity: 1;
  pointer-events: auto;
  transform: translate(-50%,0);
  transition: all calc(0.4s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}
```

### JavaScript

```js
document.querySelectorAll(".uv-zp").forEach(el => {
  const b=el.querySelector(".fire"),t=el.querySelector(".toast"),bar=t.querySelector("em"),n=t.querySelector("strong"),s=t.querySelector("small");let timer;b.addEventListener("click",()=>{clearInterval(timer);let p=0;t.classList.add("show");bar.style.setProperty("--p","0%");n.textContent="0%";s.textContent="Preparing…";timer=setInterval(()=>{p=Math.min(100,p+4);bar.style.setProperty("--p",p+"%");n.textContent=p+"%";s.textContent=p===100?"Upload complete":"Uploading…";if(p===100){clearInterval(timer);setTimeout(()=>t.classList.remove("show"),1000)}},90)})
});
```

### React

```tsx
// @ts-nocheck: setup() es JavaScript del DOM sin tipos, el mismo de la pestaña JS.
import { useEffect, useRef, type CSSProperties } from "react";

const css = `
.uv-zp {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  position: relative;
  width: 20em;
  height: 14em;
  font-size: var(--s);
}

.uv-zp>.fire {
  position: absolute;
  left: 50%;
  top: 50%;
  translate: -50% -50%;
  padding: .8em 1.25em;
  border: 0;
  border-radius: 999px;
  font: inherit;
  font-weight: 600;
  color: #fff;
  background: var(--c1);
  cursor: pointer;
  transition: transform calc(0.25s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-zp .toast {
  position: absolute;
  z-index: 2;
  left: 50%;
  bottom: .5em;
  display: flex;
  align-items: center;
  gap: .75em;
  width: 18em;
  padding: .85em;
  border-radius: 1em;
  color: var(--fg);
  background: var(--bg);
  box-shadow: inset 0 0 0 1px color-mix(in srgb,var(--fg) 10%,transparent),0 18px 45px rgba(0,0,0,.18);
  opacity: 0;
  pointer-events: none;
  transform: translate(-50%,2em);
}

.uv-zp .copy {
  display: grid;
  gap: .25em;
  flex: 1;
}

.uv-zp small {
  opacity: .5;
}

.uv-zp .copy>i {
  height: 4px;
  overflow: hidden;
  border-radius: 9px;
  background: color-mix(in srgb,var(--fg) 10%,transparent);
}

.uv-zp em {
  display: block;
  width: var(--p,0%);
  height: 100%;
  border-radius: inherit;
  background: linear-gradient(90deg,var(--c1),var(--c2));
  transition: width .18s cubic-bezier(.25,.1,.25,1);
}

.uv-zp strong {
  font-size: .75em;
  color: var(--c1);
}

.uv-zp .toast.show {
  opacity: 1;
  pointer-events: auto;
  transform: translate(-50%,0);
  transition: all calc(0.4s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}
`;

// Interacción en JavaScript del DOM: la misma que en la pestaña JS.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function setup(el: any) {
  const b=el.querySelector(".fire"),t=el.querySelector(".toast"),bar=t.querySelector("em"),n=t.querySelector("strong"),s=t.querySelector("small");let timer;b.addEventListener("click",()=>{clearInterval(timer);let p=0;t.classList.add("show");bar.style.setProperty("--p","0%");n.textContent="0%";s.textContent="Preparing…";timer=setInterval(()=>{p=Math.min(100,p+4);bar.style.setProperty("--p",p+"%");n.textContent=p+"%";s.textContent=p===100?"Upload complete":"Uploading…";if(p===100){clearInterval(timer);setTimeout(()=>t.classList.remove("show"),1000)}},90)})
}

export default function ToastProgress() {
  const ref = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const el = ref.current?.firstElementChild;
    return el ? setup(el) : undefined;
  }, []);

  return (
    <>
      <style>{css}</style>
      <div
        ref={ref} style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <div className="uv-zp"><button className="fire">Start upload</button><div className="toast"><div className="copy"><b>Uploading files</b><small>Preparing…</small><i><em></em></i></div><strong>0%</strong></div></div>
      </div>
    </>
  );
}
```

## Prompt for AI assistants

Paste this into ChatGPT, Claude, Cursor, v0 or Lovable to adapt the block to your stack (Tailwind, Vue, Svelte…):

````text
I want to add the “Upload progress toast” block (Toasts) from AIMRAN Library to my project.

## What it is
A toast with a progress bar and percentage that fills up while files upload, then confirms and slips away.

## Chosen settings
- Main color: #0071e3
- Secondary color: #8ec5ff
- Size: 16px (from 12 to 24px)
- Speed: 1x (from 0.5 to 2x)
- Text: "Uploading files"

## What I need
1. Add it to my project with the same look and animation as the reference code: same sizes, colours, radii, shadows, timings and easing.
2. It is built with plain HTML and CSS (the reference wraps it in a React component with its CSS). If my project uses something else (Vue, Svelte, Astro, plain HTML…), translate it without losing any behaviour. If I use Tailwind, turn the styles into classes; if not, keep the CSS in its own file.
3. Expose the settings above as props (or CSS variables) with those values as defaults.
4. Make it work well on phones: nothing that depends only on hover, touch targets of at least 44 px and no overflow on 320 px screens.
5. Make it look right in light and dark mode.
6. Keep it accessible: semantic HTML, roles and aria-* where needed, visible focus and keyboard support.
7. Respect prefers-reduced-motion: with reduced motion, no big animations but the same end result.

## Reference code
```tsx
// @ts-nocheck: setup() es JavaScript del DOM sin tipos, el mismo de la pestaña JS.
import { useEffect, useRef, type CSSProperties } from "react";

const css = `
.uv-zp {
  font-family: -apple-system,BlinkMacSystemFont,"SF Pro Text","Inter",system-ui,sans-serif;
  position: relative;
  width: 20em;
  height: 14em;
  font-size: var(--s);
}

.uv-zp>.fire {
  position: absolute;
  left: 50%;
  top: 50%;
  translate: -50% -50%;
  padding: .8em 1.25em;
  border: 0;
  border-radius: 999px;
  font: inherit;
  font-weight: 600;
  color: #fff;
  background: var(--c1);
  cursor: pointer;
  transition: transform calc(0.25s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}

.uv-zp .toast {
  position: absolute;
  z-index: 2;
  left: 50%;
  bottom: .5em;
  display: flex;
  align-items: center;
  gap: .75em;
  width: 18em;
  padding: .85em;
  border-radius: 1em;
  color: var(--fg);
  background: var(--bg);
  box-shadow: inset 0 0 0 1px color-mix(in srgb,var(--fg) 10%,transparent),0 18px 45px rgba(0,0,0,.18);
  opacity: 0;
  pointer-events: none;
  transform: translate(-50%,2em);
}

.uv-zp .copy {
  display: grid;
  gap: .25em;
  flex: 1;
}

.uv-zp small {
  opacity: .5;
}

.uv-zp .copy>i {
  height: 4px;
  overflow: hidden;
  border-radius: 9px;
  background: color-mix(in srgb,var(--fg) 10%,transparent);
}

.uv-zp em {
  display: block;
  width: var(--p,0%);
  height: 100%;
  border-radius: inherit;
  background: linear-gradient(90deg,var(--c1),var(--c2));
  transition: width .18s cubic-bezier(.25,.1,.25,1);
}

.uv-zp strong {
  font-size: .75em;
  color: var(--c1);
}

.uv-zp .toast.show {
  opacity: 1;
  pointer-events: auto;
  transform: translate(-50%,0);
  transition: all calc(0.4s / var(--k)) cubic-bezier(.34,1.56,.64,1);
}
`;

// Interacción en JavaScript del DOM: la misma que en la pestaña JS.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
function setup(el: any) {
  const b=el.querySelector(".fire"),t=el.querySelector(".toast"),bar=t.querySelector("em"),n=t.querySelector("strong"),s=t.querySelector("small");let timer;b.addEventListener("click",()=>{clearInterval(timer);let p=0;t.classList.add("show");bar.style.setProperty("--p","0%");n.textContent="0%";s.textContent="Preparing…";timer=setInterval(()=>{p=Math.min(100,p+4);bar.style.setProperty("--p",p+"%");n.textContent=p+"%";s.textContent=p===100?"Upload complete":"Uploading…";if(p===100){clearInterval(timer);setTimeout(()=>t.classList.remove("show"),1000)}},90)})
}

export default function ToastProgress() {
  const ref = useRef<HTMLDivElement>(null);

  useEffect(() => {
    const el = ref.current?.firstElementChild;
    return el ? setup(el) : undefined;
  }, []);

  return (
    <>
      <style>{css}</style>
      <div
        ref={ref} style={{
          "--c1": "#0071e3",
          "--c2": "#8ec5ff",
          "--s": "16px",
          "--k": "1",
          "--fg": "#1d1d1f",
          "--bg": "#f5f5f7",
        } as CSSProperties}
      >
        <div className="uv-zp"><button className="fire">Start upload</button><div className="toast"><div className="copy"><b>Uploading files</b><small>Preparing…</small><i><em></em></i></div><strong>0%</strong></div></div>
      </div>
    </>
  );
}
```

Give me the complete final code, ready to paste, and tell me in one line where to put it in my project.
````