Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
October 15, 2023 15:09
September 27, 2023 13:40
October 15, 2023 15:09
December 7, 2023 09:49
December 7, 2023 09:46
December 16, 2022 11:32
October 10, 2022 23:33
September 6, 2023 20:56
October 15, 2023 15:09
November 15, 2022 18:03
April 25, 2023 16:37
April 9, 2023 11:48
August 25, 2021 10:01
April 12, 2022 21:29
November 1, 2023 21:32
August 25, 2021 10:01
September 23, 2021 12:30
April 12, 2022 21:20

NPM npm downloads MIT

The open-source notification infrastructure for developers

The ultimate service for managing multi-channel notifications with a single API.

Explore the docs Β»

Report Bug Β· Request Feature Β· Join Our Discord Β· Roadmap Β· X Β· Notifications Directory

Available in: Node.js Β· PHP Β· Go Β· Ruby Β· Kotlin Β· Elixir Β· Rust Β· Python Β· Java

⭐️ Why Novu?

Novu provides a unified API that makes it simple to send notifications through multiple channels, including In-App, Push, Email, SMS, and Chat. With Novu, you can create custom workflows and define conditions for each channel, ensuring that your notifications are delivered in the most effective way possible.

✨ Features

  • 🌈 Single API for all messaging providers (In-App, Email, SMS, Push, Chat)
  • πŸ’… Easily manage notifications over multiple channels
  • πŸš€ Equipped with a CMS for advanced layouts and design management
  • πŸ›‘ Built-in protection for missing variables (Coming Soon)
  • πŸ“¦ Easy to set up and integrate
  • πŸ›‘ Debug and analyze multi-channel messages in a single dashboard
  • πŸ“¦ Embeddable notification center with real-time updates
  • πŸ‘¨β€πŸ’» Community-driven

πŸ“š Table Of Contents

πŸš€ Getting Started

We are excited to launch the complete Novu API and admin panel. Do you want to give it a test before the official release? Here is how:

npx novu init

After setting up your account using the cloud or docker version, you can trigger the API using the @novu/node package.

For API documentation and reference, please visit [Novu API Reference] (

To get started with the Node.js package, you can install it using npm:

npm install @novu/node
import { Novu } from '@novu/node';

const novu = new Novu(process.env.NOVU_API_KEY);

await novu.trigger('<TRIGGER_NAME>', {
  to: [
      subscriberId: '<UNIQUE_IDENTIFIER>',
      email: '',
      firstName: 'John',
      lastName: 'Doe',
  payload: {
    name: 'Hello World',
    organization: {
      logo: '',

Embeddable Notification Center

Using the Novu API and admin panel, you can easily add a real-time notification center to your web app without building it yourself. You can use our React / Vue / Angular components or an iframe embed, as well as a Web component.


Read more about how to add a notification center to your app with the Novu API here

React Component Β· Vue Component Β· Angular Component


Novu provides a single API to manage providers across multiple channels with a simple-to-use interface.

πŸ’Œ Email

πŸ“ž SMS

πŸ“± Push

πŸ‘‡ Chat

πŸ“± In-App

Other (Coming Soon...)

  • PagerDuty

πŸ“‹ Read Our Code Of Conduct

Before you begin coding and collaborating, please read our Code of Conduct thoroughly to understand the standards (that you are required to adhere to) for community engagement. As part of our open-source community, we hold ourselves and other contributors to a high standard of communication. As a participant and contributor to this project, you agree to abide by our Code of Conduct.

πŸ’» Need Help?

We are more than happy to help you. If you are getting any errors or facing problems while working on this project, join our Discord server and ask for help. We are open to discussing anything related to the project.

⚑ Immediate working space with Gitpod

Open in Gitpod

πŸ”— Links

πŸ›‘οΈ License

Novu is licensed under the MIT License - see the LICENSE file for details.

πŸ’ͺ Thanks To All Contributors

Thanks a lot for spending your time helping Novu grow. Keep rocking πŸ₯‚