Skip to main content
Novu Framework enables you to run a part of the core Novu workflow engine from within your network boundary. This also opens up a powerful new capability: you can create Novu workflows entirely in code. This is important because:
  • You can inject custom code that does nearly anything you can imagine as part of a Novu workflow
  • Your code-based workflow lives alongside your application code in source control
  • You can hydrate notification content using local data-sources, reducing what you need to sync outside of your IT boundary

What it is and how it works

Novu Framework is an application and SDK that you run locally, and communicates natively with the Novu Cloud Worker Engine via the Novu API. Novu Framework requires a single HTTP webhook-like endpoint (/api/novu or similar) to be exposed by your application. This endpoint is called a Bridge Endpoint and is used to receive events from our Worker Engine through an encrypted client-initiated tunnel. When enabled, Novu Cloud will call the Bridge Endpoint when it needs to retrieve contextual information for a given subscriber and notification. Use the npx novu init command to create a sample Bridge application with a built-in Bridge Endpoint.
Novu Framework is used as a code layer to power both workflows and agents.

Quickstart

To get started with Novu Framework, pick your preferred technology from the list below:
https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/nextjs.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=5ec58e3684000a16139f4ff526919f2d

Next.js

https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/express.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=5054e6c9ade6c8ebdba437054b0cda02

Express.js

https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/remix.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=48e1028e749ab0be235e9ca91e3a7fea

Remix

https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/nestjs.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=e15ef8566fe19695d7466e5119ecd6a2

NestJS

https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/svelte.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=3caeab7f6242b8496b7dab15a9838769

Svelte

https://mintcdn.com/novu-c5de82d9-docs-homepage-redesign/MQszelfdJHp3CgNw/images/icons/nuxt.svg?fit=max&auto=format&n=MQszelfdJHp3CgNw&q=85&s=d03999f89d9cab8c2b2c2abc9ea4a90a

Nuxt

H3

Lambda