# Beenvoice repository guidance

- Use Bun exclusively for dependency installation and workspace scripts.
- Run cross-workspace commands from the repository root; use `--filter` for app-specific tasks.
- Put platform-neutral rules, serialized types, constants, and parsing in `packages/domain`.
- Keep browser-only UI in `apps/web` and React Native/native code in `apps/mobile`.
- Do not import server implementations into mobile runtime bundles. The `AppRouter` import is type-only.
- Keep Drizzle migrations and their journal together under `apps/web/drizzle`.
- Never commit `.env`, signing credentials, native build output, receipts, or customer data.