# RPAlert

> React Performance Alert: Know your app got slow before users tell you.

RPAlert is a SaaS that monitors real-user Web Vitals in React applications and sends instant alerts (Discord, Slack) when performance degrades.

## Key Features

- Real User Monitoring (RUM) for LCP, FCP, CLS, INP
- LCP element identification (tagName, resource URL, component name)
- Client context collection (device type, network, screen size)
- Long Task detection (>50ms)
- Per-app performance thresholds with customizable alert rules
- Discord and Slack webhook notifications with rich embeds
- Minimum sample threshold to avoid false positives

## SDK (rpalert-sdk)

- npm: https://www.npmjs.com/package/rpalert-sdk
- Lightweight (<5KB gzipped), zero dependencies
- Supports vanilla JS and React (via RPAlertProvider)

### Installation

```bash
npm install rpalert-sdk
```

### React usage

```tsx
import { RPAlertProvider } from 'rpalert-sdk/react';

export default function RootLayout({ children }) {
  return (
    <RPAlertProvider apiKey={process.env.NEXT_PUBLIC_RPALERT_API_KEY}>
      {children}
    </RPAlertProvider>
  );
}
```

### Vanilla usage

```typescript
import RPAlert from 'rpalert-sdk';
RPAlert.start('your-api-key');
```

### Configuration options

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| apiKey | string | — | Required. Your RPAlert API key. |
| endpoint | string | https://rpalert.dev/api/metrics | Metrics ingestion endpoint. |
| debug | boolean | false | Log debug information to the console. |
| batchInterval | number | 30000 | Interval (ms) at which collected metrics are sent. |

## Pricing

- **Free**: 1 app, 10 alerts/mo, 7-day retention
- **Pro** ($29.99/mo): 10 apps, 1,000 alerts/mo, 30-day retention
- **Max** ($49/mo): 100 apps, 10,000 alerts/mo, 90-day retention

## Links

- Website: https://rpalert.dev
- Documentation: https://rpalert.dev/docs
- SDK Integration Guide: https://rpalert.dev/docs/integration
- API Reference: https://rpalert.dev/docs/api
- Contact: https://rpalert.dev/contact
- Terms of Service: https://rpalert.dev/terms
- Privacy Policy: https://rpalert.dev/privacy