Novu est une couche intermédiaire entre votre application et les fournisseurs de messages. Un seul appel d'API se transforme en e-mail, en SMS, en notification push ou en entrée dans la boîte de réception à l'intérieur de votre produit. Le dépôt novuhq/novu compte environ 39,6 mille étoiles, et la licence est mixte : MIT pour la plus grande partie du code et un accord propriétaire distinct pour le répertoire enterprise/packages.
Pourquoi une couche distincte alors qu'on peut appeler les fournisseurs directement
La première version des notifications est la même dans chaque produit. Quelqu'un ajoute un appel à Resend ou Postmark à l'endroit où une commande change de statut, et ça marche. Pendant les six premiers mois, il n'y a aucune raison de faire plus. Une couche intermédiaire ne devient rentable que lorsque trois exigences précises apparaissent, et chacune coûte plus cher à écrire soi-même qu'il n'y paraît au départ.
La première, ce sont les préférences des utilisateurs. Quelqu'un demande de désactiver les SMS tout en gardant l'e-mail. Quelqu'un d'autre veut les notifications de commentaires uniquement dans l'application, et les notifications de paiement partout. Il vous faut donc une matrice : utilisateur fois type d'événement fois canal, avec une valeur par défaut qui peut être remplacée à deux niveaux. S'y ajoutent une interface où l'utilisateur la règle et une vérification de cette matrice avant chaque envoi. L'écrire prend plusieurs semaines, et la maintenir dure aussi longtemps que le produit.
La deuxième, c'est l'enchaînement entre canaux. Une règle comme « afficher une notification dans l'application et, si l'utilisateur ne l'a pas lue dans les trente minutes, envoyer un e-mail » demande trois choses à la fois : un état de lecture stocké, une tâche planifiée déclenchée avec un délai et une condition évaluée au moment du déclenchement. Une simple file de tâches ne la couvre pas, car l'état de lecture doit bien venir de quelque part. Le regroupement ressemble à cela : vingt commentaires sur un billet en une heure devraient produire un seul e-mail plutôt que vingt.
La troisième, c'est un endroit unique pour les modèles. Des chaînes de messages dispersées dans le code signifient que chaque correction de faute de frappe demande un déploiement, et que la personne responsable des textes ne peut pas y toucher. Une couche de notifications déplace les modèles dans un tableau de bord où ils peuvent être modifiés sans développeur, et les versionne entre environnements.
Novu vous donne les trois dans un seul paquet. Quand aucune des trois ne vous concerne, appeler directement le fournisseur reste la bonne réponse, et Novu devient une pièce d'infrastructure de plus à maintenir.
Licence, versions et santé du projet
C'est la partie la plus importante de ce texte, car la situation de Novu en matière de licence paraît différente selon l'angle sous lequel on l'examine, et ces différences comptent lors d'un audit de dépendances.
Commençons par le dépôt. La branche par défaut de novuhq/novu est next, et sa racine ne contient aucun fichier nommé LICENSE. Elle en contient trois autres : LICENSE-MIT, LICENSE-ENTERPRISE et EE-PACKAGES-LICENSE. Le fichier LICENSE-ENTERPRISE décrit la séparation et indique clairement que tout ce qui se trouve sous enterprise/packages relève des conditions de EE-PACKAGES-LICENSE, tandis que le reste du code est sous MIT. La branche main, en revanche, porte un simple fichier LICENSE avec le texte MIT et la mention « Copyright (c) 2019 Dima Grossman », ce qui peut tromper une vérification rapide, car ce n'est pas la branche par défaut.
Le contenu de EE-PACKAGES-LICENSE est strict. C'est un accord propriétaire intitulé « Novu Proprietary Software License » qui interdit la location, la revente, la sous-licence et la fourniture de services d'hébergement commercial, interdit la modification et la rétro-ingénierie, et subordonne l'usage à une approbation écrite préalable de Novu. La phrase sur cette approbation dit en substance qu'il faut prendre contact à [contact information]. Le texte à remplacer entre crochets n'a jamais été complété : la clause exige donc une procédure qu'on ne peut pas exécuter telle qu'elle est écrite.
Ce qui relève exactement de ce régime se voit dans les noms des sous-répertoires : ai, api, auth, billing, shared-services et translation. Autrement dit, l'authentification d'entreprise, la facturation et les traductions ne font pas partie du code MIT. De plus, le fichier .gitmodules déclare un sous-module au chemin .source pointant vers git@github.com:novuhq/packages-enterprise.git, un dépôt auquel une adresse SSH publique ne donne aucun accès. La part du code derrière les fonctionnalités payantes n'est donc pas seulement licenciée autrement, elle est hors d'atteinte.
L'interface de programmation de GitHub renvoie NOASSERTION avec l'étiquette « Other » pour ce dépôt, parce que son détecteur ne sait pas exprimer une disposition en trois fichiers et un répertoire séparé. Tout outil qui récolte des métadonnées depuis GitHub vous affichera « other », ce qui est techniquement correct et pratiquement inutile.
Dans le registre npm, cela devient plus intéressant, et c'est là que les divergences sont les plus nettes. Le paquet @novu/api en version 3.19.0 ne comporte aucun champ license dans son package.json, et pourtant l'archive publiée contient un fichier LICENSE avec le texte MIT complet et la mention « Copyright (c) 2024 Novu ». Son champ repository pointe pendant ce temps vers un autre dépôt, novuhq/novu-ts, car c'est un client généré. Les paquets @novu/js, @novu/react et @novu/nextjs en 3.19.0, ainsi que @novu/framework en 2.13.0, déclarent la licence ISC et ne contiennent aucun fichier de licence dans l'archive. Il en va de même pour l'outil en ligne de commande novu en version 2.20.1. La licence ISC n'apparaît nulle part dans le dépôt et ressemble à une valeur par défaut laissée par npm init, mais formellement c'est la déclaration qui accompagne ces paquets.
Le bilan pour celui qui tient la liste de dépendances est le suivant. Le code que vous installez réellement via npm et appelez depuis votre application est destiné à un usage libre, même si les déclarations sont incohérentes : dans un cas un champ manquant avec un fichier MIT, dans un autre un champ ISC sans fichier, tandis que le dépôt dit MIT. Le régime propriétaire couvre des fonctionnalités serveur que vous n'hébergez de toute façon pas vous-même sur Novu Cloud. Si, en revanche, vous prévoyez l'auto-hébergement et voulez la connexion SSO ou les traductions, vous touchez à enterprise/packages, et un accord s'applique alors qui exige une approbation écrite avec un champ de contact vide. Consignez les deux faits dans le registre de dépendances plutôt qu'un seul.
Au-delà de la licence, la santé du projet mérite d'être connue. Le dépôt n'est pas archivé, il compte 4435 forks et 109 issues ouvertes, et la dernière modification de la branche next date du 21 août 2026. L'ancien paquet serveur @novu/node en version 2.6.6 est marqué comme obsolète, avec un message qui indique le 20 mars 2025 comme fin du support et @novu/api comme successeur. Si vous tombez sur des exemples qui utilisent @novu/node, ils sont périmés.
Le premier appel et le déclenchement d'un workflow
L'installation et la configuration se résument à un paquet et une clé.
npm install @novu/api
export NOVU_SECRET_KEY=nv_...Le client prend la clé dans le champ secretKey, et avec l'auto-hébergement on ajoute un serverURL pointant vers l'adresse de votre propre API.
import { Novu } from '@novu/api'
const novu = new Novu({ secretKey: process.env.NOVU_SECRET_KEY })
await novu.trigger({
workflowId: 'order-shipped',
to: {
subscriberId: user.id,
email: user.email,
phone: user.phone,
locale: 'en-GB',
timezone: 'Europe/London'
},
payload: {
orderNumber: order.number,
trackingUrl: order.trackingUrl
}
})Trois choses dans cet appel méritent un commentaire. Le champ workflowId pointe vers une définition de workflow plutôt que vers un canal : la décision d'envoyer un e-mail, un SMS ou les deux est donc prise en dehors du code appelant. Le champ to accepte soit un simple identifiant sous forme de chaîne, soit un objet abonné, ce qui crée ou met à jour au passage cet abonné : vous n'avez donc besoin d'aucune étape distincte pour enregistrer un utilisateur dans Novu. Le champ payload arrive dans le modèle sous forme de variables et c'est le seul endroit où votre application transmet des données métier.
L'objet abonné accepte firstName, lastName, email, phone, avatar, locale, timezone, data pour des champs personnalisés arbitraires et channels pour les jetons push. Seul subscriberId est obligatoire. Donnez-lui le même identifiant que celui de votre base de données, car le changer plus tard signifie migrer les préférences.
Il existe aussi triggerBroadcast pour envoyer à tous les abonnés, et overrides, où vous remplacez la configuration du fournisseur pour tout le workflow ou pour une seule étape. Les sections overrides.email, overrides.sms, overrides.push et overrides.chat sont marquées comme obsolètes au profit de overrides.channels et overrides.steps : utilisez donc ces dernières dans le nouveau code.
Des workflows en code avec @novu/framework
Un workflow peut être défini en cliquant dans le tableau de bord, ou en code via le paquet @novu/framework. La seconde voie garde la définition dans le dépôt avec le reste de l'application et la fait passer par la même revue de changements.
import { workflow } from '@novu/framework'
import { serve } from '@novu/framework/next'
import { z } from 'zod'
const commentWorkflow = workflow(
'comment-on-post',
async ({ payload, step }) => {
const inApp = await step.inApp('new-comment', async () => ({
subject: 'New comment',
body: `${payload.authorName} commented on your post`,
redirect: { url: `/posts/${payload.postId}`, target: '_self' }
}))
await step.delay('wait-before-email', async () => ({
type: 'regular',
amount: 30,
unit: 'minutes'
}))
await step.email(
'fallback-email',
async () => ({
subject: 'You have an unread comment',
body: `${payload.authorName} commented on your post.`
}),
{ skip: () => inApp.read }
)
},
{
payloadSchema: z.object({
postId: z.string(),
authorName: z.string()
})
}
)
export const { GET, POST, OPTIONS } = serve({ workflows: [commentWorkflow] })C'est la réponse à la question de la relance quand un canal n'aboutit pas. Le résultat de l'étape inApp porte les champs seen, read, lastSeenDate et lastReadDate : la condition skip lit donc l'état de lecture au moment où le délai est écoulé. Sans couche de notifications, vous devriez conserver cet état vous-même, planifier la tâche et évaluer la condition à son exécution.
Les étapes de canal disponibles sont email, sms, push, chat, inApp et custom, tandis que les étapes d'action sont delay, digest et throttle. L'étape delay dans sa variante regular exige les champs amount et unit, où l'unité est seconds, minutes, hours, days, weeks ou months. La variante timed prend à la place une expression cron. L'étape digest fonctionne de la même façon et accepte en plus digestKey et lookBackWindow, si bien que le regroupement se fait par billet plutôt que globalement pour tout un utilisateur.
Une contrainte importante : la route serve doit être accessible publiquement, car c'est le serveur Novu qui l'appelle à chaque étape du workflow. Dans Next.js, cela signifie une application déployée ou un tunnel pendant le travail en local. Un workflow défini en code et un workflow assemblé en cliquant dans le tableau de bord sont deux modes distincts qu'on ne peut pas mélanger librement pour le même workflow.
Préférences des utilisateurs et composant Inbox
Les préférences vivent sous l'espace de noms subscribers.preferences avec trois méthodes : list, update et bulkUpdate.
await novu.subscribers.preferences.update(
{
workflowId: 'comment-on-post',
channels: {
email: false,
sms: false,
inApp: true,
push: true,
chat: false
}
},
user.id
)
const { result } = await novu.subscribers.preferences.list({ subscriberId: user.id })Le champ workflowId est facultatif, et cette distinction décide du niveau de l'écriture. Avec lui, vous mettez à jour la préférence pour un seul workflow, sans lui la préférence globale de tout l'abonné. Les canaux sont email, sms, inApp, push, chat et tool, avec la réserve que dans le format réseau inApp apparaît sous la forme in_app : les requêtes HTTP construites à la main utilisent donc d'autres noms que la bibliothèque.
Côté interface, vous disposez de composants prêts à l'emploi pour React, dont Inbox, Bell, Notifications et Preferences, ainsi que d'un ensemble de hooks comme useNotifications, usePreferences et useCounts.
'use client'
import { Inbox } from '@novu/react'
export function NotificationBell({ subscriberHash }: { subscriberHash: string }) {
return (
<Inbox
applicationIdentifier={process.env.NEXT_PUBLIC_NOVU_APP_ID!}
subscriber={currentUser.id}
subscriberHash={subscriberHash}
appearance={{ variables: { colorPrimary: '#2563eb' } }}
/>
)
}Le champ subscriberHash est une signature HMAC générée sur le serveur à partir de la clé secrète. Sans lui, quiconque change l'identifiant dans les outils de développement voit la boîte de réception de quelqu'un d'autre : en production, il est donc obligatoire. Le champ subscriberId de ce composant est marqué comme obsolète au profit de subscriber, qui accepte une chaîne ou un objet abonné complet.
Le composant maintient une connexion WebSocket ouverte pour pouvoir insérer les nouvelles notifications sans rafraîchissement. Vous pouvez la désactiver avec realtime={false} et piloter vous-même le rafraîchissement. Avec l'auto-hébergement, l'option socketOptions.socketType prend la valeur self-hosted, car une instance locale utilise socket.io alors que le cloud utilise un autre mécanisme.
Tarifs, limites et auto-hébergement
La grille tarifaire comporte quatre niveaux et facture principalement le nombre d'exécutions de workflows plutôt que le nombre d'utilisateurs.
| Élément | Free | Pro | Team | Enterprise |
|---|---|---|---|---|
| Coût mensuel | 0 USD | à partir de 30 USD | à partir de 250 USD | sur devis |
| Exécutions de workflows incluses | 10k | 30k | 250k | 10M et plus |
| Exécutions supplémentaires | aucune | 1,20 USD pour 1k | 1,20 USD pour 1k | sur devis |
| Débit d'événements | 60 par seconde | 240 par seconde | 600 par seconde | sur devis |
| Fenêtre de digest et de délai | 24 heures | 7 jours | 90 jours | sur devis |
| Rétention de l'activité | 24 heures | 7 jours | 90 jours | sur devis |
| Membres de l'équipe | 3 | 3 | illimité | illimité |
| Nombre de workflows | 20 | 20 | 100 | sur devis |
Les chiffres Pro et Team sont donnés « à partir de », et la page des tarifs n'affiche aucun prix annuel : aucun tarif annuel n'est donc indiqué ici. Les abonnés sont illimités sur toutes les offres, ce qui compte, car il s'agit d'une facturation à l'événement plutôt qu'à la base d'utilisateurs.
Deux limites de l'offre gratuite font le plus mal et valent la peine d'être vues avant de s'engager. La fenêtre de digest est de 24 heures : un résumé hebdomadaire ne peut donc pas être construit sur cette offre. La rétention de l'activité est aussi de 24 heures, ce qui signifie qu'un signalement d'utilisateur déposé lundi matin ne peut plus être vérifié dans le journal de vendredi. L'accord de niveau de service annonce 99,9 pour cent de disponibilité sur les offres Free, Pro et Team.
L'alternative est l'auto-hébergement. La documentation décrit une variante docker compose dans laquelle un script d'installation télécharge docker-compose.yml et .env.example, génère des valeurs aléatoires pour JWT_SECRET, STORE_ENCRYPTION_KEY et NOVU_SECRET_KEY, puis démarre l'ensemble complet des services.
curl -fsSL https://raw.githubusercontent.com/novuhq/novu/next/docker/community/setup.sh | NOVU_DIR=~/novu bash
cd ~/novu && docker compose up -dLe tableau de bord devient disponible sur http://localhost:4000. Le déploiement sur un serveur exige en plus de définir HOST_NAME dans le fichier .env. L'ensemble qui démarre couvre l'API, un worker, un serveur WebSocket et le tableau de bord, plus une base de données et une file : ce n'est donc pas un seul processus mais plusieurs services à superviser. Faire passer un script du réseau directement dans un shell revient à exécuter du code que vous n'avez pas lu : télécharger ce fichier et le lire d'abord est l'ordre raisonnable.
Novu face aux alternatives
| Caractéristique | Novu | Fournisseur direct, Resend ou Postmark | Trigger.dev plus votre propre code |
|---|---|---|---|
| Canaux derrière une API | e-mail, SMS, push, chat, in-app | e-mail uniquement | autant que vous en branchez |
| Centre de préférences | intégré, par canal et par workflow | aucun hormis le désabonnement de liste | à écrire vous-même |
| Boîte de réception in-app | composant React prêt à l'emploi | aucune | à écrire vous-même |
| Fenêtres de digest et de délai | étapes digest et delay | aucune | possible, vous le définissez |
| Open source | MIT en dehors du répertoire enterprise | non | oui, Apache 2.0 dans le dépôt |
| Auto-hébergement | oui, docker compose | non | oui |
Le choix se résume à la question des préférences et de la boîte de réception in-app. Si le produit n'envoie que des e-mails transactionnels et que personne ne demande à désactiver des catégories, un fournisseur appelé directement est plus simple, moins cher et comporte moins de pièces mobiles. Si vous exploitez déjà une file de tâches et préférez garder la logique de votre côté, Trigger.dev gérera les délais et les relances, mais les préférences et le composant de boîte de réception restent à écrire par vous, et c'est l'essentiel du travail. Les outils d'e-mail de cycle de vie et de campagnes comme Loops forment une catégorie à part qui résout un autre problème et se place raisonnablement à côté de Novu plutôt qu'à sa place.
Le risque de dépendance vis-à-vis de l'éditeur (lock-in) mérite aussi d'être nommé. Les modèles assemblés dans le tableau de bord, les définitions de workflows et les préférences des abonnés vivent tous du côté de Novu. Partir signifie exporter tout cela et le recréer ailleurs, et une partie, l'historique d'activité par exemple, ne peut pas être recréée du tout. Garder les workflows en code via @novu/framework limite le problème, car les définitions restent dans votre dépôt, mais cela ne fait rien pour les préférences des utilisateurs.
L'alternative fermée de la même niche est Knock, qui résout le même problème : un événement dans le code transformé en livraison sur plusieurs canaux, en tenant compte des préférences des destinataires, du regroupement par lots et de la déduplication. La différence est fondamentale et mérite d'être pesée : il n'existe pas de variante auto-hébergée, et les flux sont définis dans le tableau de bord de l'éditeur, si bien que la logique de notification quitte votre dépôt et votre revue de code ordinaire. Il faut aussi noter que la bibliothèque serveur y est sous Apache 2.0 tandis que les paquets clients sont sous MIT.
Erreurs fréquentes
La première est d'intégrer le composant Inbox sans subscriberHash. L'identifiant de l'abonné est visible côté navigateur : sans signature HMAC, la boîte de réception de quelqu'un d'autre est à une modification dans les outils de développement. Générez la signature sur le serveur et transmettez-la au composant en prop.
La deuxième est d'utiliser un subscriberId autre que l'identifiant de votre propre base de données. Quand vous vous apercevez six mois plus tard que quelque chose d'autre aurait été plus pratique, chaque préférence rattachée à l'ancien identifiant reste où elle est, et rien ne la déplace automatiquement.
La troisième est de soumettre l'offre gratuite à des exigences qu'elle ne couvre pas. La fenêtre de digest et la rétention de l'activité y sont toutes deux de 24 heures : un résumé hebdomadaire et le diagnostic d'un signalement datant de quelques jours ne fonctionneront tout simplement pas, aussi correctement que vous écriviez le workflow.
La quatrième est une route serve qui n'est pas accessible publiquement. Le serveur Novu l'appelle à chaque étape : un workflow défini en code et déployé derrière un pare-feu ou seulement en local ne s'exécutera donc pas du tout, et le message d'erreur peut induire en erreur.
La cinquième est d'utiliser @novu/node. Le paquet est obsolète, avec une fin de support datée du 20 mars 2025, et la plupart des tutoriels sur le web le montrent encore. Écrivez le nouveau code avec @novu/api.
La sixième est de manquer la différence de nommage entre la bibliothèque et le format réseau. Le canal inApp de la bibliothèque circule sous la forme in_app : une requête construite à la main avec le nom de la bibliothèque ne changera donc silencieusement rien.
La septième est de traiter tout le dépôt comme du MIT en planifiant un auto-hébergement avec connexion d'entreprise ou traductions. Ces fonctionnalités se trouvent dans le répertoire enterprise/packages couvert par un accord propriétaire qui exige une approbation écrite préalable, et le champ de contact de son texte est resté vide.
FAQ
Novu envoie-t-il lui-même les messages, ou via des fournisseurs ?
Via des fournisseurs. Novu est la couche de contrôle, et l'envoi proprement dit passe par une intégration configurée, par exemple Resend, Postmark ou Twilio pour les SMS. Vous payez le fournisseur séparément pour l'envoi lui-même, tandis que Novu facture les exécutions de workflows.
Sous quelle licence est Novu ?
Mixte. La branche par défaut du dépôt contient LICENSE-MIT, LICENSE-ENTERPRISE et EE-PACKAGES-LICENSE, où le répertoire enterprise/packages relève d'un accord propriétaire et le reste du code du MIT. Les paquets npm le déclarent de façon incohérente : @novu/api n'a pas de champ license mais livre un fichier MIT, tandis que @novu/js, @novu/react, @novu/nextjs et @novu/framework déclarent ISC sans aucun fichier de licence dans l'archive.
L'auto-hébergement donne-t-il accès à toutes les fonctionnalités ?
Non. Les fonctionnalités de enterprise/packages, dont l'authentification d'entreprise, la facturation et les traductions, relèvent de conditions distinctes, et le code réel de ces paquets est référencé par un sous-module pointant vers un dépôt sans accès public. La variante communautaire lancée via docker compose couvre l'API, un worker, un serveur WebSocket et le tableau de bord.
Les définitions de workflows peuvent-elles vivre dans le dépôt ?
Oui, via le paquet @novu/framework. Vous définissez le workflow en TypeScript avec un payloadSchema, vous exposez une route via serve et vous le synchronisez. Il y a une condition : cette route doit être accessible publiquement, car le serveur Novu l'appelle à chaque étape.
Combien coûte Novu à mille notifications par jour ?
Mille exécutions par jour font environ 30 mille par mois, exactement le quota de l'offre Pro, dont le prix démarre à 30 USD par mois. Au-delà du quota, 1,20 USD est facturé par millier d'exécutions supplémentaires. S'y ajoute le coût du côté du fournisseur d'envoi, que Novu ne couvre pas.
Une couche de notifications a-t-elle du sens avec un seul canal ?
Rarement. Avec le seul e-mail transactionnel, sans préférences et sans boîte de réception in-app, appeler directement le fournisseur est plus simple et moins cher. Novu devient rentable au deuxième canal, ou à la première demande d'un utilisateur de désactiver un type précis de notification.
La documentation se trouve sur le site de documentation de Novu, la grille tarifaire sur la page des tarifs, et le code source dans le dépôt GitHub.