Angular SDK Quickstart

Instrument an Angular app with HTTP metrics, a global error handler, and a bug-reporter component.

Package: @mpratyush54/sdk-angular · Examples: sdk-angular/examples

Installation

npm install @mpratyush54/sdk-angular

NgModule setup

Use a browser SDK token. In the portal open Project → SDK Tokens and create a token of kind Browser. Anything in frontend config (VITE_*, NEXT_PUBLIC_*, Angular environment.ts) is bundled into public JavaScript, so never put a Server token there. Browser tokens can only send bug reports, logs and API metrics; they cannot read project config, secrets or database credentials. If an SDK token was previously embedded in a frontend, revoke it and create a new one (a browser token for the frontend, a server token for your backend).

Config fields are apiBase / token / projectId (not apiUrl / sdkToken):

import { PlatformModule } from '@mpratyush54/sdk-angular';

@NgModule({
  imports: [
    HttpClientModule,
    PlatformModule.forRoot({
      apiBase: 'https://api.example.sslip.io',
      token: 'sdk_live_…', // browser-kind SDK token
      projectId: 'your-project-id',
      environment: 'development',
      appName: 'my-angular-app',
    }),
  ],
})
export class AppModule {}

Template:

<platform-bug-reporter></platform-bug-reporter>

Standalone bootstrap

import { importProvidersFrom } from '@angular/core';
import { provideHttpClient, withInterceptorsFromDi } from '@angular/common/http';
import { PlatformModule } from '@mpratyush54/sdk-angular';

bootstrapApplication(AppComponent, {
  providers: [
    provideHttpClient(withInterceptorsFromDi()),
    importProvidersFrom(
      PlatformModule.forRoot({
        apiBase: environment.platformUrl,
        token: environment.sdkBrowserToken, // browser-kind SDK token
        projectId: environment.projectId,
      }),
    ),
  ],
});

See sdk-angular/examples/app.config.ts.

What is registered

Provider Role
PlatformHttpInterceptor Times HttpClient → /api/sdk/api-metrics
PlatformErrorHandler Global ErrorHandler
BugReporterComponent <platform-bug-reporter>

More examples

Path Topic
app.module.ts NgModule
app.config.ts Standalone
usage.component.ts HttpClient + reporter
examples/sdk-apps/angular-web Deployed demo

API reference

PlatformModule · HTTP Interceptor · Error Handler · Bug Reporter