sigil/UI
Components

Sonner

Token-styled toast notifications powered by sonner. Drop in the provider and call sonnerToast.

Import

import { Sonner, sonnerToast } from "@sigil-ui/components";

Preview

Setup

Add <Sonner /> once in your root layout:

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Sonner />
      </body>
    </html>
  );
}

Trigger toasts

sonnerToast("Event created");
sonnerToast.success("Changes saved");
sonnerToast.error("Something went wrong");
sonnerToast.info("New version available");

With description and action

sonnerToast("File uploaded", {
  description: "invoice-2024.pdf was uploaded successfully.",
  action: { label: "View", onClick: () => console.log("view") },
});

Custom position

<Sonner position="top-center" />

Props

Sonner accepts all props from the sonner library's Toaster component. Token-aware class overrides are applied by default.

PropTypeDefaultDescription
positionstring"bottom-right"Toast position
toastOptionsobjecttoken-styledOverride default class names
richColorsbooleanfalseEnable rich color variants
expandbooleanfalseExpand toasts by default
Studiodefault
Presets
primary
secondary
background
surface
text
border
accent
success
warning
error
info
display
body
mono
heading wt
600
heading trk
-0.025em
base size
16px
page margin
24px
section pad
64px
card pad
24px
grid gap
24px
stack gap
12px
global
8px
button
8px
card
12px
input
6px
border w
1px
style
card border
card shadow
btn shadow
glow
spring
Type
Duration
0.20
Bounce
1.00
easing
cubic-bezier(0.16, 1, 0.3, 1)
fast
150ms
normal
200ms
slow
300ms
hover scale
1.02
press scale
0.98
hover lift
-1px
stagger
50ms
weight
transform
hover
active scale
0.98
min-width
0px
letter sp
0.000em
icon gap
8px
shadow
hover
border
shadow
padding
24px
title size
1px
title wt
desc size
0.875px
aspect
outline
height
36px
focus ring
2px
focus ring
h1 size
2.25px
h2 size
1.875px
h3 size
1.5px
h4 size
1.25px
weight
tracking
-0.020em
leading
1.20
pattern
pattern α
0.03
noise
gradient
grad angle
180°
height
50px
blur
12px
border
padding
24px
item gap
24px
min-height
600px
padding Y
80px
content-max
680px
layout
title size
56px
desc size
18px
padding Y
64px
max-width
600px
layout
title size
36px
padding Y
48px
columns
4
gap
36px
content-max
1200px
rail-gap
24px
grid-cell
50px
cross-stroke
1.5px
navbar-h
50px
bento-gap
16px
grid lines
dots
cell borders
cell bg
Gutter
Margin
content
hero
navbar
rail visible
enabled