---
description: TypeScript error handling with nostics in the native app
globs: apps/native/**/*.ts,apps/native/**/*.tsx
alwaysApply: false
---

# TypeScript errors — use `nostics`

Define and report user-facing errors through **`nostics`** in `apps/native/src/lib/errors.ts`.

- Add diagnostic codes, titles, suggestions, and `defineDiagnostics` entries there — not ad hoc strings in components.
- Import `diagnostics` (or helpers like `getRebuildErrorTitle`) from `@/lib/errors` when surfacing errors in UI.
- Rust-side errors exposed to the frontend should map to stable codes that have entries in `errors.ts`.

```typescript
// ❌ BAD — one-off error copy in a component
toast.error("Something went wrong with the provider");

// ✅ GOOD — structured diagnostic
import { diagnostics, DIAGNOSTIC_CODES } from "@/lib/errors";
diagnostics.report(DIAGNOSTIC_CODES.EVOLVE_NO_PROVIDER);
```