@voltro/cli 0.29.0 → 0.30.1

package/templates/apps/frontend-dashboard/app.config.ts

@@ -32,7 +32,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide with no manual setup. The <LocaleSwitcher>
-  // in the layout writes the `voltro:lang` cookie + reloads. Grow the app to
+  // in the layout writes the `voltro:locale` cookie + reloads. Grow the app to
   // more languages by adding a code here + a `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-dashboard/package.json

@@ -12,17 +12,17 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-dashboard/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React,
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React,
 // use `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 
 import en from './en'

package/templates/apps/frontend-docs/package.json

@@ -12,17 +12,17 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-i18n/package.json

@@ -12,16 +12,16 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-landing/package.json

@@ -12,17 +12,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-portal/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.1",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-portal/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React use
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React use
 // `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'
 import de from './de'

package/templates/apps/frontend-saas/README.md

@@ -39,7 +39,7 @@ voltro dev            # api on :4000, this app on its configured port
 
 ## i18n
 
-Cookie-driven (no `/<locale>` URL prefix): `<LocaleSwitcher>` writes `voltro:lang`
+Cookie-driven (no `/<locale>` URL prefix): `<LocaleSwitcher>` writes `voltro:locale`
 and reloads. Every string is a key in `src/locales/en.ts`, mirrored in `de.ts`
 (`defineLocale<typeof en>()` fails the build on a missing key). Add a language
 with a new code in `app.config.ts` + a `src/locales/<code>.ts`.

package/templates/apps/frontend-saas/app.config.ts

@@ -31,7 +31,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide (SSR too). The <LocaleSwitcher> writes the
-  // `voltro:lang` cookie + reloads. Add a code + a `src/locales/<code>.ts` to
+  // `voltro:locale` cookie + reloads. Add a code + a `src/locales/<code>.ts` to
   // grow the app to more languages.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-saas/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.1",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-saas/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React use
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React use
 // `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'
 import de from './de'

package/templates/apps/frontend-spa/app.config.ts

@@ -20,7 +20,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide with no manual setup. The <LocaleSwitcher>
-  // in the layout writes the `voltro:lang` cookie + reloads. Grow the app to
+  // in the layout writes the `voltro:locale` cookie + reloads. Grow the app to
   // more languages by adding a code here + a `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-spa/package.json

@@ -12,17 +12,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-spa/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React,
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React,
 // use `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 
 import en from './en'

package/templates/apps/frontend-spa/src/pages/layout.tsx

@@ -2,7 +2,7 @@
 // so there is no SSR document to worry about here.
 //
 // The app is bilingual (see `locales` in app.config.ts): <LocaleSwitcher>
-// writes the `voltro:lang` cookie + reloads so the framework re-renders in the
+// writes the `voltro:locale` cookie + reloads so the framework re-renders in the
 // chosen language.
 
 import type { ReactNode } from 'react'

package/templates/apps/frontend-spa/src/pages/page.tsx

@@ -15,7 +15,7 @@ import { T } from '@voltro/i18n'
 import { getCatalog } from '../locales'
 
 // Locale-aware tab title: @voltro/web resolves meta({ locale }) from the
-// active locale (the `voltro:lang` cookie in this cookie-i18n app).
+// active locale (the `voltro:locale` cookie in this cookie-i18n app).
 export const meta = ({ locale }: { readonly locale: string }): PageMeta => ({
   title: getCatalog(locale)['meta.home.title'],
 })

package/templates/apps/frontend-ssr/app.config.ts

@@ -24,7 +24,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide (SSR + ISR too) with no manual setup. The
-  // <LocaleSwitcher> in the layout writes the `voltro:lang` cookie + reloads.
+  // <LocaleSwitcher> in the layout writes the `voltro:locale` cookie + reloads.
   // Grow the app to more languages by adding a code here + a
   // `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,

package/templates/apps/frontend-ssr/package.json

@@ -12,17 +12,17 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-ssr/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title> / <meta description>. This app is cookie-i18n (no `/<locale>` URL
-// prefix), so @voltro/web hands `meta` the active locale from the `voltro:lang`
+// prefix), so @voltro/web hands `meta` the active locale from the `voltro:locale`
 // cookie. Inside React, use `<T>` / `useT()` via the framework's auto-wired
 // <I18nProvider> instead.
 

package/templates/apps/frontend-ssr/src/pages/layout.tsx

@@ -3,7 +3,7 @@
 // intercepts them) after the first load.
 //
 // The app is bilingual (see `locales` in app.config.ts): nav labels come from
-// the catalog via `<T>`, and <LocaleSwitcher> writes the `voltro:lang` cookie
+// the catalog via `<T>`, and <LocaleSwitcher> writes the `voltro:locale` cookie
 // + reloads so the framework re-renders in the chosen language.
 
 import type { ReactNode } from 'react'

package/templates/apps/frontend-ssr/src/pages/page.tsx

@@ -15,7 +15,7 @@ import { getCatalog } from '../locales'
 export const renderMode = 'ssr' as const
 
 // Locale-aware tab title + description: @voltro/web resolves meta({ locale })
-// from the active locale (the `voltro:lang` cookie in this cookie-i18n app).
+// from the active locale (the `voltro:locale` cookie in this cookie-i18n app).
 export const meta = ({ locale }: { readonly locale: string }): PageMeta => ({
   title:       getCatalog(locale)['meta.ssr.title'],
   description: getCatalog(locale)['meta.ssr.description'],

package/templates/apps/frontend-ssr-api/app.config.ts

@@ -29,7 +29,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide (SSR too) with no manual setup. The
-  // <LocaleSwitcher> in the layout writes the `voltro:lang` cookie + reloads.
+  // <LocaleSwitcher> in the layout writes the `voltro:locale` cookie + reloads.
   // Grow the app to more languages by adding a code here + a
   // `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,

package/templates/apps/frontend-ssr-api/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.1",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-ssr-api/src/locales/index.ts

@@ -1,7 +1,7 @@
 // Catalog lookup OUTSIDE React — for the page's `meta({ locale, loaderData })`
 // locale-aware <title> / <meta description>. This app is cookie-i18n (no
 // `/<locale>` URL prefix), so @voltro/web hands `meta` the active locale from
-// the `voltro:lang` cookie. Inside React, use `<T>` / `useT()` via the
+// the `voltro:locale` cookie. Inside React, use `<T>` / `useT()` via the
 // framework's auto-wired <I18nProvider> instead.
 
 import en from './en'

package/templates/apps/frontend-ssr-api/src/pages/layout.tsx

@@ -2,7 +2,7 @@
 // Don't render <html>/<head>/<body> here — the framework shell owns them.
 //
 // The app is bilingual (see `locales` in app.config.ts): <LocaleSwitcher>
-// writes the `voltro:lang` cookie + reloads so the framework re-renders in the
+// writes the `voltro:locale` cookie + reloads so the framework re-renders in the
 // chosen language.
 import type { ReactNode } from 'react'
 import { useLocale, useT } from '@voltro/i18n'

package/templates/apps/frontend-static-blog/package.json

@@ -12,16 +12,16 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-status/package.json

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.1",
+    "@voltro/cli": "0.30.1",
+    "@voltro/client": "0.30.1",
+    "@voltro/env": "0.30.1",
+    "@voltro/i18n": "0.30.1",
+    "@voltro/ui-shadcn": "0.30.1",
+    "@voltro/web": "0.30.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-status/src/locales/index.ts

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for the page's `meta({ locale })` locale-aware
 // <title>. Cookie-i18n (no URL prefix), so @voltro/web hands `meta` the active
-// locale from the `voltro:lang` cookie. Inside React use `<T>` / `useT()`.
+// locale from the `voltro:locale` cookie. Inside React use `<T>` / `useT()`.
 import en from './en'
 import de from './de'
 

package/templates/apps/mobile-app/README.md

@@ -0,0 +1,58 @@
+# {{capProjectName}} — mobile (Expo + Voltro)
+
+An [Expo](https://expo.dev) (React Native) app that is the **third consumer** of
+your Voltro api — the same typed hooks you use on the web (`useSubscription` /
+`useMutation`), offline-first by default, with typed deep links and device
+registration for push.
+
+> **Expo owns the dev loop, not `voltro dev`.** This app is started with
+> `expo start` / `expo run:ios`, not `voltro dev`. The sibling api still runs
+> under `voltro dev`; this app connects to it over the network.
+
+## Run it
+
+```sh
+# 1. In one shell — the api (scaffold it with --api=api-backend):
+voltro dev
+
+# 2. Point this app at the api. On a simulator/device use your machine's LAN
+#    address, NOT localhost:
+export EXPO_PUBLIC_API_URL="http://192.168.x.x:4000"
+
+# 3. In another shell — the app:
+pnpm ios        # or: pnpm android · pnpm start (Expo Go)
+```
+
+## What's here
+
+| Path | What |
+|---|---|
+| `src/lib/deeplinks.ts` | the typed deep-link table + pure resolver (**tested**) |
+| `src/lib/sync.ts` | the background-sync decision layer (**tested**) |
+| `src/lib/notifications.ts` | build a `_voltro_devices` row from a push token (**tested**) |
+| `src/client.ts` | the Voltro client + the **M0 seam** (read its header) |
+| `src/persistence.ts` | RN key-value with the secure/plain split |
+| `src/app/*` | Expo Router screens (list, detail, settings) |
+| `voltro.mobile.ts` | which api(s) this app consumes |
+
+## Honest status (read before you expect the loop to work on a device)
+
+The **pure logic** in `src/lib/*` is real and unit-tested (`pnpm test`). The
+**client wiring** — building the runtime + subscription cache + rpc client that
+the hooks read — is **not yet implemented for React Native**: on the web it lives
+in `@voltro/web`'s web-coupled boot. Wiring an RN-safe equivalent is Phase **M0**
+in the framework's mobile plan (`plans/open/mobile/`). Until it lands,
+`buildApiHandles()` in `src/client.ts` returns an empty map and the screens show
+their loading state — deliberately, not a crash. `src/client.ts`'s header spells
+out exactly what M0 must build.
+
+The tests here run without a simulator. Booting the app on a device (`expo
+run:ios`) is your Expo/EAS CI step — there is no iOS/Android toolchain in the
+framework repo's sandbox.
+
+## Tests
+
+```sh
+pnpm test        # the pure lib — no simulator needed
+pnpm typecheck   # tsc over the app (needs Expo/RN types installed)
+```

package/templates/apps/mobile-app/app.config.ts

@@ -0,0 +1,33 @@
+// Expo app config for the {{projectName}} mobile app.
+//
+// NOTE: this is EXPO's config, NOT Voltro's `type: 'web'|'api'` app.config. A
+// mobile app is not run by `voltro dev` — Expo owns Metro and the simulator
+// (`expo start` / `expo run:ios`). The sibling api this app consumes still runs
+// under `voltro dev`; the app connects to it over HTTP/WebSocket via
+// `EXPO_PUBLIC_API_URL` (see src/client.ts).
+//
+// `scheme` is the custom URL scheme that makes deep links open THIS app
+// (`{{appName}}://orders/42`). Keep it in sync with the deep-link table in
+// src/lib/deeplinks.ts — `voltro mobile doctor` (planned) checks this.
+import type { ExpoConfig } from 'expo/config'
+
+const config: ExpoConfig = {
+  name: '{{capProjectName}}{{capAppName}}',
+  slug: '{{projectName}}-{{appName}}',
+  scheme: '{{appName}}',
+  version: '0.0.0',
+  orientation: 'portrait',
+  userInterfaceStyle: 'automatic',
+  newArchEnabled: true,
+  ios: { supportsTablet: true, bundleIdentifier: 'com.{{projectName}}.{{appName}}' },
+  android: { package: 'com.{{projectName}}.{{appName}}' },
+  plugins: [
+    'expo-router',
+    'expo-secure-store',
+    // Add 'expo-notifications' here once you wire the push pipeline
+    // (see plans/open/mobile/02-push-pipeline.md).
+  ],
+  experiments: { typedRoutes: true },
+}
+
+export default config

package/templates/apps/mobile-app/babel.config.js

@@ -0,0 +1,5 @@
+// Expo's Babel preset — required for expo-router + React Native transforms.
+module.exports = function babel(api) {
+  api.cache(true)
+  return { presets: ['babel-preset-expo'] }
+}

package/templates/apps/mobile-app/metro.config.js

@@ -0,0 +1,20 @@
+// Metro config — the ONLY Voltro-specific wrinkle in a monorepo: watch the
+// workspace root so `@voltro/*` (and the sibling api's generated types) resolve
+// from the repo, not just this app's node_modules. In a standalone (non-
+// monorepo) app you can delete this file; Expo's default config is enough.
+const { getDefaultConfig } = require('expo/metro-config')
+const path = require('node:path')
+
+const projectRoot = __dirname
+const workspaceRoot = path.resolve(projectRoot, '../../..')
+
+const config = getDefaultConfig(projectRoot)
+config.watchFolders = [workspaceRoot]
+config.resolver.nodeModulesPaths = [
+  path.resolve(projectRoot, 'node_modules'),
+  path.resolve(workspaceRoot, 'node_modules'),
+]
+// Prefer a single physical React across the workspace (RN + web share one).
+config.resolver.disableHierarchicalLookup = true
+
+module.exports = config

package/templates/apps/mobile-app/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@{{projectName}}/{{appName}}",
+  "version": "0.0.0",
+  "private": true,
+  "main": "expo-router/entry",
+  "scripts": {
+    "start": "expo start",
+    "ios": "expo run:ios",
+    "android": "expo run:android",
+    "web": "expo start --web",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@voltro/client": "0.30.1",
+    "@voltro/react-native": "0.30.1",
+    "expo": "^52.0.0",
+    "expo-constants": "~17.0.0",
+    "expo-linking": "~7.0.0",
+    "expo-router": "~4.0.0",
+    "expo-secure-store": "~14.0.0",
+    "expo-status-bar": "~2.0.0",
+    "@react-native-async-storage/async-storage": "1.23.1",
+    "@react-native-community/netinfo": "11.4.1",
+    "react": "^19.0.0",
+    "react-native": "0.76.5"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  }
+}