@betterumami/angular

Angular bindings for BetterUmami analytics (standalone API).

Install

npm install @betterumami/angular

Usage

// app.config.ts
import { provideBetterUmami } from '@betterumami/angular';

export const appConfig: ApplicationConfig = {
  providers: [
    provideBetterUmami({ websiteId: '...', hostUrl: 'https://analytics.example.com' }),
  ],
};

import { BetterUmamiService } from '@betterumami/angular';

private umami = inject(BetterUmamiService);

onSignup() {
  this.umami.track('signup-button', { plan: 'pro' });
}

Pageviews are tracked via Router NavigationEnd when @angular/router is present; otherwise core's History API hooks handle navigation. Peer dependencies: @angular/core >= 16, @angular/router >= 16, rxjs >= 7.

Build: this package uses ng-packagr (pnpm build with the Angular toolchain installed).

See the root README for all config options.