Cursor rule

1---
2description: Environment access — only through env.ts
3globs: apps/native/**/*.ts,apps/native/**/*.tsx
4alwaysApply: false
5---
6 
7# Environment variables — `env.ts` only
8 
9**Do not use `process.env` or `import.meta.env` anywhere except `apps/native/src/lib/env.ts`.**
10 
11All app code reads deployment settings through exports from that module (`settings`, `nixmacEnvironment`, `getProfileValue`, etc.).
12 
13Benefits: single validation path, typed profile JSON, no scattered env reads, and build-time profile baking stays consistent with Rust (`build.rs`).
14 
15```typescript
16// ❌ BAD
17const key = import.meta.env.VITE_POSTHOG_KEY;
18 
19// ✅ GOOD
20import { settings } from "@/lib/env";
21const key = settings.posthogKey;
22```
23