# Novu — Open-Source Notification Infrastructure

> Unified API for in-app, email, SMS, push, and chat notifications. React components included. 38K+ GitHub stars.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

# Novu — Open-Source Notification Infrastructure

## Quick Use

```bash
npx novu@latest dev
```

Or add to your project:
```bash
npm install @novu/node
```

```typescript
import { Novu } from '@novu/node';

const novu = new Novu({ secretKey: 'your-api-key' });

await novu.trigger('ai-task-complete', {
    to: { subscriberId: 'user-123', email: 'user@example.com' },
    payload: {
        taskName: 'RAG Pipeline Build',
        status: 'completed',
        duration: '3m 42s',
    },
});
// Sends via: in-app notification + email + Slack (configured per workflow)
```

In-app notification center (React):
```bash
npm install @novu/react
```

```tsx
import { Inbox } from '@novu/react';

function App() {
    return <Inbox applicationIdentifier="your-app-id" subscriberId="user-123" />;
}
```

---

## Intro

Novu is the leading open-source notification infrastructure with 38,800+ GitHub stars. It provides a unified API to send notifications across every channel — in-app inbox, email, SMS, push, and chat (Slack, Discord, Teams) — with a single trigger call. For AI applications, Novu powers task completion alerts, agent status updates, pipeline monitoring notifications, and user engagement messages. It includes React components for an embeddable notification inbox, visual workflow builders, subscriber preference management, and multi-tenant support.

Works with: React, Vue, Angular, Node.js, Python, any REST client, SendGrid, AWS SES, Twilio, Slack, Discord. Best for teams building AI applications that need multi-channel notifications. Setup time: under 5 minutes.

---

## Novu Features

### Multi-Channel Delivery

```
One trigger call -> Multiple channels:

  novu.trigger('alert') → ┌─ In-App Inbox
                          ├─ Email (SendGrid/SES)
                          ├─ SMS (Twilio)
                          ├─ Push (FCM/APNs)
                          └─ Chat (Slack/Discord)
```

### Visual Workflow Builder

Define notification logic with code or the visual editor:

```typescript
import { workflow } from '@novu/framework';

const aiAlert = workflow('ai-task-alert', async ({ step, payload }) => {
    // Step 1: Always send in-app
    await step.inApp('inbox', async () => ({
        body: `Task "${payload.taskName}" ${payload.status}`,
    }));

    // Step 2: Wait, then send email if unread
    await step.delay('wait', () => ({ amount: 5, unit: 'minutes' }));

    await step.email('email-fallback', async () => ({
        subject: `AI Task: ${payload.taskName}`,
        body: `Your task completed in ${payload.duration}.`,
    }));
});
```

### Embeddable Inbox (React)

```tsx
import { Inbox } from '@novu/react';

function NotificationCenter() {
    return (
        <Inbox
            applicationIdentifier="app-id"
            subscriberId="user-123"
            appearance={{ colorPrimary: '#E8654A' }}
        />
    );
}
// Renders a full notification inbox with read/unread, actions, and preferences
```

### AI App Notification Patterns

| Pattern | Trigger |
|---------|--------|
| **Task complete** | Agent finished a coding task |
| **Pipeline alert** | RAG pipeline failed or degraded |
| **Cost threshold** | LLM spend exceeded daily budget |
| **Quality alert** | Hallucination rate above threshold |
| **User engagement** | Weekly AI usage summary |

### Subscriber Preferences

Let users control their notification channels:
```typescript
// Users can toggle: email ✅, SMS ❌, in-app ✅, Slack ✅
await novu.subscribers.setPreferences('user-123', {
    channels: { email: true, sms: false, in_app: true, chat: true }
});
```

---

## FAQ

**Q: What is Novu?**
A: Novu is open-source notification infrastructure with 38,800+ GitHub stars providing a unified API for in-app, email, SMS, push, and chat notifications with visual workflows and React inbox components.

**Q: Why use Novu for AI apps?**
A: AI applications need notifications for task completion, pipeline alerts, cost thresholds, and user engagement. Novu handles all channels with one API call, includes subscriber preferences, and provides an embeddable React inbox.

**Q: Is Novu free?**
A: Yes, open-source under MIT. Self-host for free. Novu Cloud has a free tier (30K events/month).

---

## Source & Thanks

> Created by [Novu](https://github.com/novuhq). Licensed under MIT.
>
> [novu](https://github.com/novuhq/novu) — ⭐ 38,800+


---
Source: https://tokrepo.com/en/workflows/novu-open-source-notification-infrastructure-ecdca64c
Author: AI Open Source