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_*, Angularenvironment.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