M2kishore / novu

⭐ A fully functional real-time notification center for your web and react apps. The only open-source notifications infrastructure that manages multi-channel content, scheduled notifications, digest engine, user preferences, and delivers Email, SMS, Push and Chat notifications using a single API. ⚡

Notification management simplified.

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

Explore the docs »

Report Bug · Request Feature · Join Our Discord · Roadmap · Twitter

⭐️ Why

Building a notification system is hard , at first, it seems like just sending an email, but in reality, it's just the beginning. Users today expect a multi-channel communication experience via email, SMS, push, chat, and other channels. An ever-growing list of providers is popping up daily, and notifications are spread around the code. Novu's goal is to simplify notifications and provide developers with the tools to create meaningful communication between the system and its users.

✨ Features

• 🌈 Single API for all messaging providers (Email, SMS, Push, Chat)
• 💅 Easily manage notification 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
• Embeddable notification center
• Providers
  • Email
  • SMS
  • Push
  • Chat
  • In-App
  • Others
• Need Help?
• Links
• License

🚀 Getting Started

We are excited to launch the complete Novu API and admin panel. 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.

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: '[e-mail]',
      firstName: 'John',
      lastName: 'Doe',
    }],
    payload: {
      name: "Hello World",
      organization: {
        logo: 'https://happycorp.com/logo.png',
      },
    },
  }
);

Embeddable notification center

Using the Novu API and admin panel you can easily add real-time notification center to your web-app without the hassle of building it yourself. You can use our React component or an iframe embed if you are not using React.

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

Providers

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

💌 Email

• Sendgrid
• Mailgun
• SES
• Postmark
• NodeMailer
• Mailjet
• Mandrill
• SendinBlue
• EmailJS
• SparkPost

📞 SMS

• Twilio
• Plivo
• SNS
• Nexmo - Vonage
• Sms77
• Telnyx
• Termii
• Bandwidth
• RingCentral

📱 Push

• FCM
• Expo
• Pushwoosh
• SNS

👇 Chat

• Slack
• Discord
• MS Teams
• Mattermost

📱 In-App

• Novu
• MagicBell

Other (Coming Soon...)

• PagerDuty

💻 Need Help?

We are more than happy to help you. If you are getting any error or facing problems while working with the project, then join our Discord server and ask for help. We are open to discuss anything related to the project.

📋 Read our Code of Conduct

Before moving on to coding and collaborating, please read our Code of Conduct throroughly to understand our standards (that you are required to adhere to) regarding how to engage in a community.

🔗 Links

• Home page
• Contribution Guidelines
• Run Novu Locally

🛡️ 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. Thanks a lot! Keep rocking 🥂