npmpackage.info

Gathering detailed insights and metrics for react-toast-notifications

Other packages similar to react-toast-notifications

react-hot-toast

2.5.2

Smoking hot React Notifications. Lightweight, customizable and beautiful by default.

sonner

2.0.6

An opinionated toast component for React.

react-native-toast-notifications

3.4.0

[![Version][version-badge]][package] [![MIT License][license-badge]][license]

react-notifications-component

4.0.1

React component for creating notifications on the fly

Gathering detailed insights and metrics for react-toast-notifications

react-toast-notifications - 2.5.1 | npmpackage.info

react-toast-notifications

🍞 A toast notification system for react

2.5.1

2,171

MIT

JavaScript

15.85 kB

25,229,774 2.1

Installations

npm install react-toast-notifications

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

12.13.1

NPM Version

6.12.1 Score

84.7

Supply Chain

87.7

Quality

74.9

Maintenance

100

Vulnerability

99.6

License

Pull Requests

Open

15

Total

85

Closed

37

Merged

33

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

jossmac

Download Statistics

Total Downloads

25,229,774

Last Day

2,211

Last Week

64,501

Last Month

343,281

Last Year

3,098,136

GitHub Statistics

MIT License

2,171 Stars

91 Commits

174 Forks

14 Watchers

12 Branches

19 Contributors

Updated on Jun 25, 2025

Bundle Size

50.51 kB

Minified

15.85 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 19 Contributors

Package Meta Information

Latest Version

2.5.1

Package Id

react-toast-notifications@2.5.1

Size

13.11 kB

NPM Version

6.12.1

Node Version

12.13.1

Published on

Jul 08, 2021

Total Downloads

Cumulative downloads

Total Downloads

25,229,774

???? Not Maintained

This was a great project to learn from and fulfilled the requirements it set out to. Unfortunately, I can no-longer give this project the time it needs. Consider react-hot-toast as an alternative, or look at the source and make your own ???? (there really isn't much to it).

React Toast Notifications

A configurable, composable, toast notification system for react.

https://jossmac.github.io/react-toast-notifications

Install

1yarn add react-toast-notifications

Use

Wrap your app in the ToastProvider, which provides context for the Toast descendants.

1import { ToastProvider, useToasts } from 'react-toast-notifications';
2
3const FormWithToasts = () => {
4  const { addToast } = useToasts();
5
6  const onSubmit = async value => {
7    const { error } = await dataPersistenceLayer(value);
8
9    if (error) {
10      addToast(error.message, { appearance: 'error' });
11    } else {
12      addToast('Saved Successfully', { appearance: 'success' });
13    }
14  };
15
16  return <form onSubmit={onSubmit}>...</form>;
17};
18
19const App = () => (
20  <ToastProvider>
21    <FormWithToasts />
22  </ToastProvider>
23);

ToastProvider Props

For brevity:

PlacementType is equal to 'bottom-left' | 'bottom-center' | 'bottom-right' | 'top-left' | 'top-center' | 'top-right'.
TransitionState is equal to 'entering' | 'entered' | 'exiting' | 'exited'.

Property	Description
autoDismissTimeout `number`	Default `5000`. The time until a toast will be dismissed automatically, in milliseconds.
autoDismiss `boolean`	Default: `false`. Whether or not to dismiss the toast automatically after a timeout.
children `Node`	Required. Your app content.
components `{ ToastContainer, Toast }`	Replace the underlying components.
newestOnTop `boolean`	Default `false`. When true, insert new toasts at the top of the stack.
placement `PlacementType`	Default `top-right`. Where, in relation to the viewport, to place the toasts.
portalTargetSelector `string`	Which element to attach the container's portal to. Uses `document.body` when not provided.
transitionDuration `number`	Default `220`. The duration of the CSS transition on the `Toast` component.

Toast Props

Property	Description
appearance	Used by the default toast. One of `success`, `error`, `warning`, `info`.
children	Required. The content of the toast notification.
autoDismiss `boolean`	Inherited from `ToastProvider` if not provided.
autoDismissTimeout `number`	Inherited from `ToastProvider`.
onDismiss: `Id => void`	Passed in dynamically. Can be called in a custom toast to dismiss it.
placement `PlacementType`	Inherited from `ToastProvider`.
transitionDuration `number`	Inherited from `ToastProvider`.
transitionState: `TransitionState`	Passed in dynamically.

Hook

The useToast hook has the following signature:

1const {
2  addToast,
3  removeToast,
4  removeAllToasts,
5  updateToast,
6  toastStack,
7} = useToasts();

The addToast method has three arguments:

The first is the content of the toast, which can be any renderable Node.
The second is the Options object, which can take any shape you like. Options.appearance is required when using the DefaultToast. When departing from the default shape, you must provide an alternative, compliant Toast component.
The third is an optional callback, which is passed the added toast ID.

The removeToast method has two arguments:

The first is the ID of the toast to remove.
The second is an optional callback.

The removeAllToasts method has no arguments.

The updateToast method has three arguments:

The first is the ID of the toast to update.
The second is the Options object, which differs slightly from the add method because it accepts a content property.
The third is an optional callback, which is passed the updated toast ID.

The toastStack is an array of objects representing the current toasts, e.g.

1[
2  {
3    content: 'Something went wrong',
4    id: 'generated-string',
5    appearance: 'error',
6  },
7  { content: 'Item saved', id: 'generated-string', appearance: 'success' },
8];

Replaceable Components

To bring each toast notification inline with your app, you can provide alternative components to the ToastProvider:

1import { ToastProvider } from 'react-toast-notifications';
2
3const MyCustomToast = ({ appearance, children }) => (
4  <div style={{ background: appearance === 'error' ? 'red' : 'green' }}>
5    {children}
6  </div>
7);
8
9const App = () => (
10  <ToastProvider components={{ Toast: MyCustomToast }}>...</ToastProvider>
11);

To customize the existing component instead of creating a new one, you may import DefaultToast:

1import { DefaultToast } from 'react-toast-notifications';
2export const MyCustomToast = ({ children, ...props }) => (
3  <DefaultToast {...props}>
4    <SomethingSpecial>{children}</SomethingSpecial>
5  </DefaultToast>
6);

Alternatives

This library may not meet your needs. Here are some alternative I came across whilst searching for this solution:

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

3

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

126 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-6chw-6frg-f759
Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
Warn: Project is vulnerable to: GHSA-c6rq-rjc2-86v2
Warn: Project is vulnerable to: GHSA-257v-vj4p-3w2h
Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-p28h-cc7q-c4fg
Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-3wcq-x3mq-6r9p
Warn: Project is vulnerable to: GHSA-phwq-j96m-2c2q
Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6
Warn: Project is vulnerable to: GHSA-vh7m-p724-62c2
Warn: Project is vulnerable to: GHSA-r9p9-mrjm-926w
Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh
Warn: Project is vulnerable to: GHSA-6h5x-7c5m-7cr7
Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q
Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3
Warn: Project is vulnerable to: MAL-2023-462
Warn: Project is vulnerable to: GHSA-8mmm-9v2q-x3f9
Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
Warn: Project is vulnerable to: GHSA-vfrc-7r7c-w9mx
Warn: Project is vulnerable to: GHSA-7wwv-vh3v-89cq
Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
Warn: Project is vulnerable to: GHSA-pfq8-rq6v-vf5m
Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
Warn: Project is vulnerable to: GHSA-6x33-pw7p-hmpq
Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37
Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22
Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp
Warn: Project is vulnerable to: GHSA-7r28-3m3f-r2pr
Warn: Project is vulnerable to: GHSA-r8j5-h5cx-65gg
Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546
Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574
Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm
Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695
Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-4xcv-9jjx-gfj3
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-92xj-mqp7-vmcj
Warn: Project is vulnerable to: GHSA-wxgw-qj99-44c2
Warn: Project is vulnerable to: GHSA-5rrq-pxf6-6jx5
Warn: Project is vulnerable to: GHSA-8fr3-hfg3-gpgp
Warn: Project is vulnerable to: GHSA-gf8q-jrpm-jvxq
Warn: Project is vulnerable to: GHSA-2r2c-g63r-vccr
Warn: Project is vulnerable to: GHSA-cfm4-qjh2-4765
Warn: Project is vulnerable to: GHSA-x4jg-mjrx-434g
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w
Warn: Project is vulnerable to: GHSA-h7cp-r72f-jxh6
Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59
Warn: Project is vulnerable to: GHSA-566m-qj78-rww5
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-wvhm-4hhf-97x9
Warn: Project is vulnerable to: GHSA-h4hr-7fg3-h35w
Warn: Project is vulnerable to: GHSA-gj77-59wh-66hg
Warn: Project is vulnerable to: GHSA-hqhp-5p83-hx96
Warn: Project is vulnerable to: GHSA-3949-f494-cm99
Warn: Project is vulnerable to: GHSA-x7hr-w5r2-h6wg
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-h9rv-jmmf-4pgx
Warn: Project is vulnerable to: GHSA-hxcc-f52p-wc94
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-4g88-fppr-53pp
Warn: Project is vulnerable to: GHSA-4jqc-8m5r-9rpr
Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6
Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj
Warn: Project is vulnerable to: GHSA-c9g6-9335-x697
Warn: Project is vulnerable to: GHSA-vx3p-948g-6vhq
Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9
Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw
Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc
Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh
Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p
Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq
Warn: Project is vulnerable to: GHSA-cf4h-3jhx-xvhq
Warn: Project is vulnerable to: GHSA-9m6j-fcg5-2442
Warn: Project is vulnerable to: GHSA-hh27-ffr2-f2jc
Warn: Project is vulnerable to: GHSA-rqff-837h-mm52
Warn: Project is vulnerable to: GHSA-8v38-pw62-9cw2
Warn: Project is vulnerable to: GHSA-hgjh-723h-mx2j
Warn: Project is vulnerable to: GHSA-jf5r-8hm2-f872
Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6
Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v
Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h
Warn: Project is vulnerable to: GHSA-g78m-2chm-r7qv
Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

2.1

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to react-toast-notifications

Other packages similar to react-toast-notifications

react-toast-notifications

Installations

Developer Guide

No

CommonJS

12.13.1

6.12.1

Score

Pull Requests

15

85

37

33

Issues

0

0

0

Releases

Unable to fetch releases

Languages

Developer

Download Statistics

GitHub Statistics

Bundle Size

50.51 kB

15.85 kB

Maintainers

Package Meta Information

Total Downloads

25,229,774

Dependencies

Peer Dependencies

Dev Dependencies

???? Not Maintained

React Toast Notifications

Install

Use

ToastProvider Props

Toast Props

Hook

Replaceable Components

Alternatives

10

10

3

0

0

0

0

0

0

0

2.1

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads