โจ Features
- ๐ Single API for all messaging providers (In-App, Email, SMS, Push, Chat)
- ๐ Fully managed GitOps Flow, deployed from your CI
- ๐ฅ Define workflow and step validations with Zod or JSON Schema
- ๐ React Email/Maizzle/MJML integrations
- ๐ Equipped with a CMS for advanced layouts and design management
- ๐ก Debug and analyze multi-channel messages in a single dashboard
- ๐ฆ Embeddable notification center with real-time updates
- ๐จโ๐ป Community-driven
๐ Getting Started
To get started, type the following command in your Terminal.
npx novu-labs@latest echo
Notification Workflows as Code
For API documentation and reference, please visit Echo API Reference.
client.workflow('comment-on-post', async ({step, subscriber}) => {
const inAppResponse = await step.inApp('in-app-step', async (inputs) => {
return {
body: renderReactComponent(inputs)
};
}, {
inputSchema: {
// ...JSON Schema or ZOD/Ajv/Class Validators definition
}
});
// Novu Worker Engine will manage the state and durability of each step in isolation
const { events } = await step.digest('1 day');
await step.email('email-step', async () => {
return {
subject: 'E-mail Subject',
body: renderReactEmail(<ReactEmailComponent events={digestedEvents} />);
}
}, {
// Step-level inputs defined in code and controlled in the novu Cloud UI by a Non-Technical Team member
inputSchema: {
// ...JSON Schema
},
providers: {
sendgrid: async (inputs) => {
// Echo runs as part of your application, so you have access to your database or resources
return {
to: email,
ipPoolName: 'custom-pool'
};
}
},
skip: () => {
// Write custom skip logic
return inAppResponse.seen || subscriber.isOnline;
}
});
// Define your workflow trigger payload using json schema and custom validation;
}, {
payloadSchema: {
// ...JSON Schema
}
});
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.
![notification-center-912bb96e009fb3a69bafec23bcde00b0](https://user-images.githubusercontent.com/80174214/193887395-f1c95042-b4e6-480e-a89c-a78aa247fa90.gif)
Providers
Novu provides a single API to manage providers across multiple channels with a simple-to-use interface.
๐ Email
- [x] Sendgrid
- [x] Netcore
- [x] Mailgun
- [x] SES
- [x] Postmark
- [x] Custom SMTP
- [x] Mailjet
- [x] Mandrill
- [x] 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
๐ Chat
- [x] Slack
- [x] Discord
- [x] MS Teams
- [x] Mattermost
๐ฑ In-App
- [x] Novu
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.
๐ช Thanks To All Contributors
Thanks a lot for spending your time helping Novu grow. Keep rocking ๐ฅ