Documentation

v2.1.9 · MIT

Notifications, with character.

A toast library that pairs functional notifications with characterful robots. Tree-shakeable, mobile-tuned.

Three steps are all it takes.

Install, import, toast.

Full guide →
1

Install

Tree-shakeable, mobile-tuned, with character.

npm install robot-toast
2

Import a toast

Add toast in your app

import { toast } from 'robot-toast'
3

Toast it

Call from anywhere

toast({ message: 'Saved!' })
10 KB
core, gzipped
16
built-in robots
06
positions
3.850k
total downloads

Built for production.

  • 01

    Tree-shakeable robots

    Import only the variants you use. Each robot is a data URL, so unused characters never reach the bundle.

  • 02

    React hook included

    useRobotToast() and useToastOnMount() ship in a dedicated subpath. React stays an optional peer dependency.

  • 03

    Promise lifecycle

    toast.promise() handles loading, success, and error states in a single call — including dynamic messages from the resolved value.

  • 04

    Accessible by default

    role="alert" for errors and warnings, role="status" otherwise. Keyboard pause, focus restore, ARIA-correct out of the box.

  • 05

    Fully themeable

    Light, dark, and colored presets — or pass your own style object and own the look entirely.