mobile development
- Repo stars 0
- Author repo skills-registry
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Env read
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Mobile Development
## Stack
Expo 54, React Native 0.81, expo-router (file-based routing), Tamagui v4 (UI), TypeScript strict mode.
## Local Build Prerequisites
Required to run `expo run:android` or `expo prebuild`:
| Requirement | Check | Install |
|---|---|---|
| Java JDK 17 | `java -version` (must show `17.x`) | `brew install openjdk@17` |
| Android SDK | `echo $ANDROID_HOME` (must be set) | `mise run install` |
If `expo run:android` fails with a Java error:
```bash
brew install openjdk@17
export JAVA_HOME="$(brew --prefix openjdk@17)/libexec/openjdk.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"
```
If `expo run:android` fails with `ANDROID_HOME not set` or SDK not found:
```bash
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$PATH"
```
Both are set permanently by `mise run install`. If missing, re-run it or add to `~/.zshrc` manually.
iOS builds require Xcode (App Store). No additional toolchain needed beyond Xcode.
## Imports
Use `@/` path alias for project root: `@/lib/supabase`, `@/lib/posthog`.
## UI Components
Use Tamagui components with shorthand props. Never use raw React Native `View`/`Text`.
```tsx
// ✅
import { YStack, XStack, Text, Button, Card, Spinner, ScrollView } from 'tamagui';
<YStack gap="$4" p="$4">
<Text fos="$6" fow="bold">Title</Text>
<Button>Action</Button>
</YStack>
// ❌
import { View, Text } from 'react-native';
```
Common shorthand: `bg` (background), `p`/`px`/`py` (padding), `m`/`mt` (margin), `br` (borderRadius), `bw` (borderWidth), `boc` (borderColor), `fos` (fontSize), `fow` (fontWeight), `col` (color), `ai` (alignItems), `jc` (justifyContent), `gap`, `elevate`, `bordered`.
## Routing
File-based via expo-router:
- `app/_layout.tsx` — layout wrappers (Stack, Tabs)
- `app/index.tsx` — home screen
- `app/settings.tsx` — named route
Use `Stack` with `headerShown: false` (current convention).
## New Screen
```tsx
import { YStack, Text } from 'tamagui';
export default function MyScreen() {
return (
<YStack f={1} ai="center" jc="center" bg="$background">
<Text>My Screen</Text>
</YStack>
);
}
```
## Supabase
```tsx
import { supabase } from '@/lib/supabase';
```
Single shared client. Uses `EXPO_PUBLIC_SUPABASE_URL` and `EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY`.
## Theme
Default theme is `dark`. TamaguiProvider wraps the app in `_layout.tsx` with `defaultTheme="dark"`.
## Environment Variables
All public config uses `EXPO_PUBLIC_*` prefix. Access via `process.env.EXPO_PUBLIC_*`.
---
> Source: [Ampli-Group/agentic-mobile-blueprint](https://github.com/Ampli-Group/agentic-mobile-blueprint) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
Sections and files
Listed in source order.
sections -> Stack → Local Build Prerequisites → Imports → UI Components → Routing → New Screen
terms -> Expo 54, React Native 0.81, expo-router (file-based routing), Tamagui v4 (UI), TypeScript strict mode. · Both are set permanently by mise run install. · iOS builds require Xcode (App Store). · Use @/ path alias for project root: @/lib/supabase, @/lib/posthog. · Use Tamagui components with shorthand props. · Use Stack with headerShown: false (current convention). · Single shared client. · Default theme is dark.
files/cmd -> expo run:android · expo prebuild · java -version · 17.x · brew install openjdk@17 · echo $ANDROID_HOME · mise run install · ANDROID_HOME not set
body sha256 -> ce5b8f7558f5
Stack
Expo 54, React Native 0.81, expo-router (file-based routing), Tamagui v4 (UI), TypeScript strict mode.
Local Build Prerequisites
Required to run
expo run:androidorexpo prebuild: Requirement · Check · Install Java JDK 17 ·java -version(must show17.x) ·brew install openjdk@17Android SDK ·echo $ANDROID_HOME(must be set) ·mise run installIfexpo run:androidfails with a Java error:Imports
Use
@/path alias for project root:@/lib/supabase,@/lib/posthog.UI Components
Use Tamagui components with shorthand props. Never use raw React Native
View/Text. Common shorthand:bg(background),p/px/py(padding),m/mt(margin),br(borderRadius),bw(borderWidth),boc(borderColor),fos(fontSize),fow(fontWeight),col(color),ai(alignItems),jc(justifyContent),gap,elevate,bordered.Routing
File-based via expo-router:
app/_layout.tsx— layout wrappers (Stack, Tabs)app/index.tsx— home screenapp/settings.tsx— named route UseStackwithheaderShown: false(current convention).