--- title: 'Angular In-App Notifications Quickstart - Novu Inbox' description: "Create a Novu account and integrate the Novu Inbox component into your Angular application to display real-time in-app notifications for your subscribers." sidebarTitle: 'Angular' --- Add real-time in-app notifications to Angular using the Novu Inbox component and the `@novu/js` SDK. This guide uses @novu/js javascript sdk to build the Inbox component in Angular. Novu currently does not support native Angular Inbox component. # Add Novu Inbox to Angular App Install `@novu/js`. Mount the Inbox in your header, navbar, or sidebar. Latest docs: https://docs.novu.co/platform/quickstart/angular ## Install ```bash npm install @novu/js ``` ## Component ```ts import { NovuUI } from '@novu/js/ui'; const novu = new NovuUI({ options: { applicationIdentifier: 'YOUR_APPLICATION_IDENTIFIER', subscriber: 'YOUR_SUBSCRIBER_ID', }, }); novu.mountComponent({ name: 'Inbox', props: {}, element: document.getElementById('notification-inbox'), }); ``` ## Subscriber ID Use the app's existing auth system to get a unique user identifier for subscriberId. If no auth system exists, use `YOUR_SUBSCRIBER_ID`. ## Appearance Extract design tokens from the host app and apply via the appearance configuration. Only set values extracted from the host app's design system. ## Rules ALWAYS: - Detect the project's package manager and use it for installation - Mount the Inbox inline in existing UI - no new pages or wrappers - Follow Angular conventions (services, modules, existing project patterns) - Use the existing auth system to source subscriberId when available NEVER: - Create wrapper components or new pages just for the inbox - Add code comments - Introduce styles not in the host app ## Verify Before Responding 1. Is `@novu/js` installed with the project's package manager? 2. Is the Inbox mounted inline in existing UI? 3. Is subscriberId sourced from the auth system when available? If any fails, revise. ## Create a Novu account [Create a Novu account](https://dashboard.novu.co/auth/sign-up) or [sign in](https://dashboard.novu.co/auth/sign-in) to access the Novu dashboard. ## Create an Angular application Run the following command to create a new Angular app using [angular cli](https://angular.dev/tools/cli/setup-local#install-the-angular-cli): ```bash ng new novu-inbox-angular cd novu-inbox-angular ``` ## Install `@novu/js` The [Novu JavaScript SDK](/platform/sdks/javascript) gives you access to the Inbox component. Run the following command to install the SDK: ```package-install npm install @novu/js ``` ## Add the Inbox component Update the `src/app/app.ts` file to add the Inbox component. You'll need to provide your applicationIdentifier and subscriberId: Explore the full `angular-inbox` example in the [Novu examples repository](https://github.com/novuhq/novu). If you’re signed in to your Novu account, then the applicationIdentifier and subscriberId 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. 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.html` file: ```html title="src/app/app.html"
```
## Run Your Application Start your development server: ```package-install 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](https://dashboard-v2.novu.co/auth/sign-in). 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! " 7. Once you’ve added the subject and body, close the editor. 8. Click **Trigger**. 9. 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 Explore JavaScript SDK API reference for more advanced use cases. Design and manage advanced notification workflows. Manage multiple tenants within an organization.