۱. بسته‌ها را نصب کن

SDK مرورگر و اتصال React را با هم نصب کن.

npm install @ashkarhq/browser @ashkarhq/react

۲. آشکار را به React وصل کن

یک client بساز و Error Boundary را دور اپ قرار بده تا خطاهای رندر هم ثبت شوند.

import { init } from "@ashkarhq/browser";
import { ErrorBoundary } from "@ashkarhq/react";

export const ashkar = init({
  dsn: "https://app.ashkarhq.ir/api/v1/events",
  projectKey: "YOUR_PUBLIC_KEY",
  environment: "production",
  release: "web@1.0.0",
});

root.render(
  <ErrorBoundary client={ashkar} fallback={<p>Something went wrong.</p>}>
    <App />
  </ErrorBoundary>,
);

۳. یک خطای آزمایشی بفرست

برای مطمئن شدن از اتصال، این کد را موقتاً در یک دکمه یا effect اجرا کن.

await ashkar.captureException(
  new Error("Ashkar React test"),
);
await ashkar.flush();

۴. نتیجه را در Issues ببین

پروژه را در داشبورد باز کن و «Ashkar React test» را پیدا کن. از این به بعد خطاهای معمول مرورگر و خطاهای Error Boundary خودکار ثبت می‌شوند.