Skip to content
/ novu Public
forked from novuhq/novu

πŸš€ The open-source notifications infrastructure. A fully-featured microservice to send SMS, E-mail, Slack and Push notifications. Embeddable notification center for React with real-time updates, content management, and much more...

License

Notifications You must be signed in to change notification settings

guywal/novu

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

hacktoberfest-readme-dark

hacktoberfest-readme-light



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 Novu?

Building a notification system is complicated. 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 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

πŸ“‹ Read Our Code Of Conduct

Before moving on to coding and collaborating, please read our Code of Conduct thoroughly to understand our standards (that you are required to adhere to) regarding how to engage in the community. We take our open source community seriously and hold ourselves and other contributors to high standards of communication. By participating and contributing to this project, you agree to uphold our Code of Conduct.

πŸš€ 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: '[email protected]',
      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 a real-time notification center to your web app without building it yourself. You can use our React component or an iframe embed if you are not using React.

notification-center-912bb96e009fb3a69bafec23bcde00b0

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

πŸ“ž SMS

πŸ“± Push

πŸ‘‡ Chat

  • Slack
  • Discord
  • MS Teams
  • Mattermost

πŸ“± In-App

Other (Coming Soon...)

  • PagerDuty

🀡 Meet Jarvis

Meet Jarvis, a shell client sporting a dashing text gradient for all your Novu needs. Jarvis makes the following functions as simple as a few yes or no questions:

  • Reinstall Novu
  • Run Novu
    • Full Project
    • Web and API
    • API only
    • Docs
  • Test Novu
    • Web tests
    • API tests

To run Jarvis at the root of Novu, you can use one of the following commands

npm run start
npm run jarvis

Want to look through Jarvis' source code? Check out: Jarvis.js

πŸ’» 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.

πŸ”— 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 πŸ₯‚

About

πŸš€ The open-source notifications infrastructure. A fully-featured microservice to send SMS, E-mail, Slack and Push notifications. Embeddable notification center for React with real-time updates, content management, and much more...

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.1%
  • JavaScript 3.1%
  • HTML 2.2%
  • Handlebars 0.7%
  • Dockerfile 0.4%
  • EJS 0.3%
  • Shell 0.2%