blockcode-toast

Toast provider for React/Next.js.

Install

npm i blockcode-toast

Uso rápido

import { ToastProvider, useToast } from "blockcode-toast"

function App() {
  const toast = useToast()

  // Forma 1 — título + subtítulo
  toast.success("Salvo!", "Alterações gravadas.")

  // Forma 2 — objeto (recomendado quando há mais opções)
  toast.error({
    title: "Erro de rede",
    subtitle: "Tente novamente em instantes.",
    duration: 5000,
  })

  return <button onClick={() => toast.info("Olá")}>Toast</button>
}

export default function Root() {
  return (
    <ToastProvider position="top">
      <App />
    </ToastProvider>
  )
}

API

| Método | Exemplo | |--------|---------| | toast.success(msg) | Só título | | toast.success(title, subtitle) | Título + subtítulo | | toast.success({ title, subtitle, duration }) | Objeto completo | | toast.show({ type, title, subtitle?, duration? }) | Qualquer variante |

subtitle e description são equivalentes; prefira subtitle.

Modo de teste

<ToastProvider testMode={process.env.NODE_ENV === "development"}>
  <App />
</ToastProvider>

O painel permite editar título e subtítulo, escolher a variante, testar todas em sequência e disparar o toast.

Dev local

npm run dev

Abre o playground em http://localhost:5173 com testMode ativo.