Install

npm install robot-toastcopy

Minimal

By default, v2 shows no robot unless you explicitly ask for one. This keeps bundles small.

import { toast } from 'robot-toast';

// Minimal — shows text only, no robot (v2 default is opt-in)
toast({
  message: 'Hello, World!',
  position: 'bottom-right',
});copy

With a built-in robot

Import the robot you want as a data URL — only the ones you import end up in your bundle.

import { toast } from 'robot-toast';
import { wave } from 'robot-toast/robots';  // tree-shakeable

toast({
  message: 'Hello, World!',
  position: 'bottom-right',
  robotVariant: wave,
});copy

toast.promise()

Attach a loading/success/error lifecycle to a promise.

toast.promise(fetch('/api/save'), {
  loading: 'Saving…',
  success: 'Saved!',
  error:   'Save failed',
});copy

React hook (optional)

A thin wrapper exposing toast as a stable-ref hook. React is an optional peer dep.

import { useRobotToast } from 'robot-toast/react';

function SaveButton() {
  const toast = useRobotToast();
  return <button onClick={() => toast.success('Saved!')}>Save</button>;
}copy

All 16 built-in variants

Import the ones you need from `robot-toast/robots`.

Two were renamed from v1: head-palm → headPalm, type → typing.

What's new vs v1

• • Bundle dropped 36%. Core: 61 KB → 39 KB. Robots are lazy-imported.
• • Opt-in robots. Omitting robotVariant shows no robot now. Use "default" or import from robot-toast/robots.
• • Mobile drag fixed. touch-action: none, cached rects, swipe-to-dismiss.
• • ARIA roles. role="alert" for errors/warnings; role="status" otherwise.
• • React subpath. useRobotToast() + useToastOnMount().
• • toast.promise() with callbacks for dynamic messages.