Quickstart

Novu Angular Quickstart Guide

Create an account and learn how to start using Novu Inbox Notification in your angular application.

This guide walks you through integrating Novu’s Inbox into your Angular application for real time in-app notifications, from setup to triggering your first notification. By the end, you'll have a working notification inbox.

This guide uses @novu/js headless library to build the Inbox component in Angular. Novu currently does not support native Angular Inbox component.

Create an Angular application

Create a new Angular app with angular cli using the command below. Skip this step if you already have an existing project:

ng new novu-inbox-angular

Navigate to the newly created project:

cd novu-inbox-angular

Install the required package

Run the command below to install Novu headless SDK, which provides required component for Inbox UI:

npm install @novu/js

Add the Inbox component

Update the src/app/app.component.ts file to add the Inbox component passing and :

src/app/app.component.ts
import { Component, ViewChild, ElementRef, AfterViewInit } from '@angular/core';
import { RouterOutlet } from '@angular/router';
import { NovuUI } from '@novu/js/ui';
 
@Component({
  selector: 'app-root',
  standalone: true,
  imports: [RouterOutlet],
  templateUrl: './app.component.html',
  styleUrl: './app.component.css',
})
export class AppComponent implements AfterViewInit {
  @ViewChild('novuInbox') novuInbox!: ElementRef<HTMLElement>;
  title = 'inbox-angular';
 
  ngAfterViewInit() {
    const novu = new NovuUI({
      options: {
        applicationIdentifier: 'YOUR_APPLICATION_IDENTIFIER',
        subscriberId: 'YOUR_SUBSCRIBER_ID',
      },
    });
 
    novu.mountComponent({
      name: 'Inbox',
      props: {},
      element: this.novuInbox.nativeElement,
    });
  }
}

Sign in to get your own API keys

If you’re signed in to your Novu account, then the and are automatically entered in the code sample above. Otherwise, you can manually retrieve them:

  • applicationIdentifier - In the Novu dashboard, click API Keys, and then locate your unique Application Identifier.
  • subscriberId - This represents a user in your system (typically the user's ID in your database). For quick start purposes, an auto-generated subscriberId is provided for your Dashboard user.

Note: If you pass a subscriberId that does not exist yet, Novu will automatically create a new subscriber with that ID.

Add the Inbox component to your application

Add a #novuInbox reference to your application in the starting of the src/app/app.component.html file:

src/app/app.component.html
<div #novuInbox></div>

Run Your Application

Start your development server:

npm run start

Once the application is running, a bell icon will appear on the top left side of the screen. Clicking it opens the notification inbox UI.

Currently, there are no notifications. Let’s trigger one!

Trigger your first notification

In this step, you'll create a simple workflow to send your first notification via the Inbox component. Follow these steps to set up and trigger a workflow from your Novu dashboard.

  1. Go to your Novu dashboard.
  2. In the sidebar, click Workflows.
  3. Click Create Workflow. Enter a name for your workflow (e.g., "Welcome Notification").
  4. Click Create Workflow to save it.
  5. Click the Add Step icon in the workflow editor and then select In-App as the step type.
  6. In the In-App template editor, enter the following:
  • Subject: "Welcome to Novu"
  • Body: "Hello, world! "
  1. Once you’ve added the subject and body, close the editor.
  2. Click Trigger.
  3. Click Test Workflow.

View the notification in your app

Go back to your Angular app, then click the bell icon.

You should see the notification you just sent from Novu! 🎉

Next steps

On this page