Mobile

Valcraven includes a full-featured native app for iOS and Android, built with Expo and living in apps/mobile. It authenticates against the same backend as the web app and shares all request/response logic through the @valcraven/core workspace package — no duplicated schemas, types, or API-calling code.

The mobile app is opt-in: a new project scaffolded with /valcraven-create is web-only by default, and you add apps/mobile when you actually want a phone client. This section explains what the app is, how to run it, and how much of the web experience it mirrors.

In this section

• The Expo app — what apps/mobile is, the Expo stack it runs on, how to run it locally, and how it shares logic with the web app via @valcraven/core.
• Web/mobile parity — which features the mobile app covers (auth, dashboard, settings, notifications, chat) and the copy-model behind packages/core.

Related

• Architecture → Monorepo — how apps/web, apps/mobile, apps/realtime, and packages/core fit together.
• Authentication — the Better Auth system the mobile app signs in against.
• AI chat — the realtime Worker the mobile chat screen connects to.