Product
Introducing Reports: An Extensible Reporting Framework for Socket Data
Explore exportable charts for vulnerabilities, dependencies, and usage with Reports, Socket’s new extensible reporting framework.
By André Staltz - Apr 21, 2026
Launch Week Day 1: Socket for Jira Is Now Available.Learn More →
itstoaster
Advanced tools
🔔 itstoaster
A lightweight, theme-aware, and customizable toast notification system — built for modern web apps.
📦 Installation
npm install itstoaster
or
yarn add itstoaster
🛠️ Usage
1. Import JavaScript and CSS
import { Toaster } from "itstoaster";
import "itstoaster/style.css";
2. Create a toast instance
const toast = new Toaster({
containerId: "custom-toast-container", // optional
stack: 5 // optional: max number of toasts visible at once
});
3. Show a toast
toast.success({
title: "Success!",
description: "Your settings have been saved.",
duration: 3000, // optional (default: 3000ms)
dismissable: true, // optional
position: "top-right" // optional: top-left, top-center, top-right
});
toast.warning({
title: "Warning!",
description: "Your action might have unintended consequences.",
duration: 5000, // optional
dismissable: false, // optional
position: "top-center" // optional
});
toast.error({
title: "Error!",
description: "Something went wrong.",
duration: 4000, // optional
dismissable: true, // optional
position: "top-left" // optional
});
toast.info({
title: "Information",
description: "This is some informational text.",
duration: 4000, // optional
dismissable: true, // optional
position: "top-left" // optional
});
⚙️ Toast Options
| Option | Type | Default | Description |
|---|---|---|---|
title | string | null | null | Optional title text |
description | string | null | null | Optional description |
duration | number | false | 3000 | How long toast stays (in ms). Use false to disable auto-dismiss |
dismissable | boolean | false | Show a close button |
position | string | top-right | One of: top-left, top-center, top-right |
icon | string | Based on type | Override the default icon (see below) |
🌈 Theme Support
- Automatically follows system theme
- To force dark mode, add to your
<html>tag:
<html data-theme="dark">
🌟 Default Icons
| Type | Icon name |
|---|---|
| success | check_circle |
| warning | exclamation_circle |
| error | triangular_error |
| info | info_circle |
| close | cross |
✅ You can override any icon by passing a custom icon name in the icon option.
📍 Positioning
Toasts can be positioned at:
top-lefttop-centertop-right(default)
📦 Toaster Initialization Options
When creating a new Toaster instance, you can pass these options:
| Option | Type | Description |
|---|---|---|
containerId | string | Optional ID to use for the toast container element |
stack | number | Max number of toasts shown at once (default: 3) |
✅ Features
- 🚀 Lightweight and fast
- 🎨 Light/dark/system theme support
- 📌 Position control
- 📚 Custom title & description
- 🧱 Stackable with limit
- 🧑🎨 Icon override
- ❌ Dismissable option
- ⚡ No framework needed
📃 License
MIT
🧑💻 Author
Made with ❤️ by @dipeshmurmu2005
Keywords
FAQs
A lightweight toast notification package for JavaScript
We found that itstoaster demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Package last updated on 25 Apr 2025
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Product
Socket for Jira Is Now Available
Socket for Jira lets teams turn alerts into Jira tickets with manual creation, automated ticketing rules, and two-way sync.
By Jeppe Hasseriis - Apr 20, 2026
Company News
Socket Named Top Sales Organization by RepVue
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
By Sarah Gooding - Apr 17, 2026