novu

The open-source communication infrastructure for agents and products

39,488 stars TypeScript Markdown Skills API Spec #agents#communication#email#inbox
AI Prompts & Specs

Repository: novuhq/novu


Stars: 38833

README.md

<div align="center">
<a href="https://go.novu.co/github?utm_campaign=readme-logo" target="_blank" rel="noopener noreferrer"

<picture>

<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/2233092/213641039-220ac15f-f367-4d13-9eaf-56e79433b8c1.png">
<img alt="Novu Logo" src="https://user-images.githubusercontent.com/2233092/213641043-3bbb3f21-3c53-4e67-afe5-755aeb222159.png" width="280"/>
</picture>
</a>
</div>

<br/>
<p align="center">
<a href="https://www.producthunt.com/products/novu" target="_blank" rel="noopener noreferrer"

<img src="https://img.shields.io/badge/Product%20Hunt-Golden%20Kitty%20Award%202023-yellow" alt="Product Hunt">

</a>
<a href="https://news.ycombinator.com/item?id=38419513" target="_blank" rel="noopener noreferrer"
><img src="https://img.shields.io/badge/Hacker%20News-%231-%23FF6600" alt="Hacker News"></a>
<a href="https://www.npmjs.com/package/@novu/react" target="_blank" rel="noopener noreferrer"
<img src="https://img.shields.io/npm/v/@novu/react" alt="NPM">

</a>
<a href="https://www.npmjs.com/package/@novu/js" target="_blank" rel="noopener noreferrer"
<img src="https://img.shields.io/npm/dm/@novu/js" alt="npm downloads">

</a>
</p>

<h1 align="center">
The &lt;Inbox /&gt; infrastructure for modern products
</h1>

<div align="center">
The notification platform that turns complex multi-channel delivery into a single component. Built for developers, designed for growth, powered by open source.
</div>

<p align="center">
<br />
<a href="https://go.novu.co/github?utm_source=github&utm_medium=readme&utm_campaign=learn-more-link" rel="dofollow"><strong>Learn More ยป</strong></a>
<br />

<br/>
<a href="https://github.com/novuhq/novu/issues/new?assignees=&labels=type%3A+bug&template=bug_report.yml&title=%F0%9F%90%9B+Bug+Report%3A+" target="_blank" rel="noopener noreferrer"
>Report a bug</a>
ยท
<a href="https://docs.novu.co" target="_blank" rel="noopener noreferrer"
>Docs</a>
ยท
<a href="https://go.novu.co/github?utm_campaign=readme_website" target="_blank" rel="noopener noreferrer"
>Website</a>
ยท
<a href="https://discord.novu.co" target="_blank" rel="noopener noreferrer"
>Join our Discord</a>
ยท
<a href="https://go.novu.co/changelog" target="_blank" rel="noopener noreferrer"
>Changelog</a>
ยท
<a href="https://go.novu.co/roadmap" target="_blank" rel="noopener noreferrer"
>Roadmap</a>
ยท
<a href="https://twitter.com/novuhq" target="_blank" rel="noopener noreferrer"
>X</a>
ยท
<a href="https://go.novu.co/contact?utm_source=github&utm_medium=readme&utm_campaign=contact-us-link" target="_blank" rel="noopener noreferrer"
>Contact us</a>
.
<a href="https://www.recent.dev">Recent.dev</a>
</p>

โญ๏ธ Why Novu?

Novu provides a unified API that makes it simple to send notifications through multiple channels, including Inbox/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

- Embeddable Inbox component with real-time support
- Single API for all messaging providers (Inbox/In-App, Email, SMS, Push, Chat)
- Digest Engine to combine multiple notification in to a single E-mail
- No-Code Block Editor for Email
- Notification Workflow Engine
- Embeddable user preferences component gives your subscribers control over their notifications
- Community-driven

๐Ÿš€ Getting Started

Create a free account and follow the instructions on the dashboard.

๐Ÿ“š Table of contents

- Getting Started
- Embeddable Inbox and Preferences
- Providers
- Email
- SMS
- Push
- Chat
- In-App
- Others
- Need Help?
- Links
- License

Embeddable Inbox component

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, or build your own via our API and SDK. React native, Vue, and Angular are coming soon.

<div align="center">
<img width="4800" height="2700" alt="Novu's Embeddable Inbox components" src="https://github.com/user-attachments/assets/00224c75-7ed0-4e19-b6fd-2a0bdced6258" />

Read more about how to add a notification center Inbox to your app.

</div>

Providers

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

#### ๐Ÿ’Œ Email

- [x] Sendgrid
- [x] Netcore
- [x] Mailgun
- [x] SES
- [x] Postmark
- [x] Custom SMTP
- [x] Mailjet
- [x] Mandrill
- [x] Brevo (formerly SendinBlue)
- [x] MailerSend
- [x] Infobip
- [x] Resend
- [x] SparkPost
- [x] Outlook 365

#### ๐Ÿ“ž SMS

- [x] Twilio
- [x] Plivo
- [x] SNS
- [x] Nexmo - Vonage
- [x] Sms77
- [x] Telnyx
- [x] Termii
- [x] Gupshup
- [x] SMS Central
- [x] Maqsam
- [x] 46elks
- [x] Clickatell
- [x] Burst SMS
- [x] Firetext
- [x] Infobip
- [ ] Bandwidth
- [ ] RingCentral

#### ๐Ÿ“ฑ Push

- [x] FCM
- [x] Expo
- [x] APNS
- [x] OneSignal
- [x] Pushpad
- [ ] Pushwoosh

#### ๐Ÿ‘‡ Chat

- [x] Slack
- [x] Discord
- [x] MS Teams
- [x] Mattermost

#### ๐Ÿ“ฑ In-App

- [x] Novu

๐Ÿ“‹ 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.

- Home page
- Contribution guidelines
- Run Novu locally

๐Ÿ›ก๏ธ License

Novu is a commercial open source company, which means some parts of this open source repository require a commercial license. The concept is called "Open Core," where the core technology is fully open source, licensed under MIT license, and the enterprise code is covered under a commercial license ("/enterprise" Enterprise Edition). Enterprise features are built by the core engineering team of Novu which is hired in full-time.

The following modules and folders are licensed under the enterprise license:

- enterprise folder at the root of the project and all of their subfolders and modules
- apps/web/src/ee folder and all of their subfolders and modules
- apps/dashboard/src/ee folder and all of their subfolders and modules

๐Ÿ’ช Thanks to all of our contributors

Thanks a lot for spending your time helping Novu grow. Keep rocking ๐Ÿฅ‚

<a href="https://novu.co/contributors?utm_source=github" target="_blank" rel="noopener noreferrer">
<img src="https://contributors-img.web.app/image?repo=novuhq/novu" alt="Contributors"/>
</a>