references/EXAMPLE-expo.md · 24000
rney}> Your Burrito Journey {getJourneyMessage()} ) }
const styles = StyleSheet.create({ container: { flex: 1, backgroundColor: colors.background, padding: spacing.md, }, card: { backgroundColor: colors.cardBackground, borderRadius: borderRadius.md, padding: spacing.lg, ...shadows.md, }, title: { fontSize: typography.sizes.xl, fontWeight: typography.weights.bold, color: colors.text, marginBottom: spacing.md, }, stats: { backgroundColor: colors.statsBackground, padding: spacing.md, borderRadius: borderRadius.sm, }, statsTitle: { fontSize: typography.sizes.lg, fontWeight: typography.weights.semibold, color: colors.text, marginBottom: spacing.sm, }, infoRow: { flexDirection: 'row', marginBottom: spacing.xs, }, infoLabel: { fontSize: typography.sizes.md, fontWeight: typography.weights.bold, color: colors.text, marginRight: spacing.xs, }, infoValue: { fontSize: typography.sizes.md, color: colors.text, }, errorButton: { backgroundColor: colors.danger, borderRadius: borderRadius.sm, padding: spacing.md, alignItems: 'center', marginTop: spacing.lg, }, buttonText: { color: colors.white, fontSize: typography.sizes.md, fontWeight: typography.weights.semibold, }, journey: { marginTop: spacing.lg, }, journeyTitle: { fontSize: typography.sizes.lg, fontWeight: typography.weights.semibold, color: colors.text, marginBottom: spacing.sm, }, journeyText: { fontSize: typography.sizes.md, color: colors.text, lineHeight: 24, }, })
---
## babel.config.js
```js
module.exports = function (api) {
api.cache(true)
return {
presets: ['babel-preset-expo'],
plugins: [
['babel-plugin-react-compiler'],
'react-native-reanimated/plugin', // Must be last
],
}
}
src/config/posthog.ts
import PostHog from 'posthog-react-native'
import Constants from 'expo-constants'
// Configuration loaded from app.config.js extras via expo-constants
// Environment variables are read at build time in app.config.js
const apiKey = Constants.expoConfig?.extra?.posthogProjectToken as string | undefined
const host = (Constants.expoConfig?.extra?.posthogHost as string) || 'https://us.i.posthog.com'
const isPostHogConfigured = apiKey && apiKey !== 'phc_your_project_token_here'
if (__DEV__) {
console.log('PostHog config:', {
apiKey: apiKey ? `SET` : 'NOT SET',
host,
isConfigured: isPostHogConfigured,
})
}
if (!isPostHogConfigured) {
console.warn(
'PostHog project token not configured. Analytics will be disabled. ' +
'Set POSTHOG_PROJECT_TOKEN in your .env file to enable analytics.'
)
}
/**
* PostHog client instance for Expo
*
* Configuration loaded from app.config.js extras via expo-constants.
* Required peer dependencies: expo-file-system, expo-application,
* expo-device, expo-localization
*
* For React Native Web targets, use @react-native-async-storage/async-storage
* instead of expo-file-system (Web and macOS targets not supported by expo-file-system).
*
* @see https://posthog.com/docs/libraries/react-native
*/
export const posthog = new PostHog(apiKey || 'placeholder_key', {
// PostHog API host
host,
// Disable PostHog if project token is not configured
disabled: !isPostHogConfigured,
// Capture app lifecycle events:
// - Application Installed, Application Updated
// - Application Opened, Application Became Active, Application Backgrounded
captureAppLifecycleEvents: true,
// Enable debug mode in development for verbose logging
debug: __DEV__,
// Batching: queue events and flush periodically to optimize battery usage
flushAt: 20, // Number of events to queue before sending
flushInterval: 10000, // Interval in ms between periodic flushes
maxBatchSize: 100, // Maximum events per batch
maxQueueSize: 1000, // Maximum queued events (oldest dropped when full)
// Feature flags
preloadFeatureFlags: true, // Load flags on initialization
sendFeatureFlagEvent: true, // Track getFeatureFlag calls for experiments
featureFlagsRequestTimeoutMs: 10000, // Timeout for flag requests (prevents blocking)
// Network settings
requestTimeout: 10000, // General request timeout in ms
fetchRetryCount: 3, // Number of retry attempts for failed requests
fetchRetryDelay: 3000, // Delay between retries in ms
})
export const isPostHogEnabled = isPostHogConfigured
src/contexts/AuthContext.tsx
import React, { createContext, useState, useEffect, use } from 'react'
import type { ReactNode } from 'react'
import { usePostHog } from 'posthog-react-native'
import { storage } from '../services/storage'
import type { User } from '../services/storage'
interface AuthContextType {
user: User | null
isLoading: boolean
login: (username: string, password: string) => Promise<boolean>
logout: () => Promise<void>
incrementBurritoConsiderations: () => Promise<void>
}
const AuthContext = createContext<AuthContextType | undefined>(undefined)
interface AuthProviderProps {
children: ReactNode
}
export function AuthProvider({ children }: AuthProviderProps) {
const posthog = usePostHog()
const [user, setUser] = useState<User | null>(null)
const [isLoading, setIsLoading] = useState(true)
useEffect(() => {
const restoreSession = async () => {
try {
const storedUsername = await storage.getCurrentUser()
if (storedUsername) {
const existingUser = await storage.getUser(storedUsername)
if (existingUser) {
setUser(existingUser)
posthog.identify(storedUsername, {
$set: { username: storedUsername },
})
}
}
} catch (error) {
console.error('Failed to restore session:', error)
} finally {
setIsLoading(false)
}
}
restoreSession()
}, [posthog])
// React Compiler auto-memoizes these callbacks - no useCallback needed!
const login = async (username: string, password: string): Promise<boolean> => {
if (!username.trim() || !password.trim()) {
return false
}
try {
const existingUser = await storage.getUser(username)
const isNewUser = !existingUser
const userData: User = existingUser || {
username,
burritoConsiderations: 0,
}
await storage.saveUser(userData)
await storage.setCurrentUser(username)
setUser(userData)
posthog.identify(username, {
$set: { username },
$set_once: { first_login_date: new Date().toISOString() },
})
posthog.capture('user_logged_in', {
username,
is_new_user: isNewUser,
})
return true
} catch (error) {
console.error('Login error:', error)
return false
}
}
const logout = async () => {
posthog.capture('user_logged_out')
posthog.reset()
await storage.removeCurrentUser()
setUser(null)
}
const incrementBurritoConsiderations = async () => {
if (user) {
const updatedUser: User = {
...user,
burritoConsiderations: user.burritoConsiderations + 1,
}
setUser(updatedUser)
await storage.saveUser(updatedUser)
}
}
return (
<AuthContext
value={{
user,
isLoading,
login,
logout,
incrementBurritoConsiderations,
}}
>
{children}
</AuthContext>
)
}
/**
* React 19: Use the `use` API instead of useContext
* - Can be called conditionally (unlike useContext)
* - Enables more flexible component composition
*/
export function useAuth() {
const context = use(AuthContext)
if (context === undefined) {
throw new Error('useAuth must be used within an AuthProvider')
}
return context
}
src/services/storage.ts
import AsyncStorage from '@react-native-async-storage/async-storage'
const CURRENT_USER_KEY = 'currentUser'
const USERS_KEY = 'users'
export interface User {
username: string
burritoConsiderations: number
}
/**
* Storage service for persisting user data
* Uses AsyncStorage (React Native's async key-value storage)
*/
export const storage = {
/**
* Get the currently logged in user's username
*/
getCurrentUser: async (): Promise<string | null> => {
try {
return await AsyncStorage.getItem(CURRENT_USER_KEY)
} catch (error) {
console.error('Error getting current user:', error)
return null
}
},
/**
* Set the currently logged in user's username
*/
setCurrentUser: async (username: string): Promise<void> => {
try {
await AsyncStorage.setItem(CURRENT_USER_KEY, username)
} catch (error) {
console.error('Error setting current user:', error)
}
},
/**
* Remove the current user (logout)
*/
removeCurrentUser: async (): Promise<void> => {
try {
await AsyncStorage.removeItem(CURRENT_USER_KEY)
} catch (error) {
console.error('Error removing current user:', error)
}
},
/**
* Get all stored users
*/
getUsers: async (): Promise<Record<string, User>> => {
try {
const data = await AsyncStorage.getItem(USERS_KEY)
return data ? JSON.parse(data) : {}
} catch (error) {
console.error('Error getting users:', error)
return {}
}
},
/**
* Get a specific user by username
*/
getUser: async (username: string): Promise<User | null> => {
try {
const users = await storage.getUsers()
return users[username] || null
} catch (error) {
console.error('Error getting user:', error)
return null
}
},
/**
* Save a user to storage
*/
saveUser: async (user: User): Promise<void> => {
try {
const users = await storage.getUsers()
users[user.username] = user
await AsyncStorage.setItem(USERS_KEY, JSON.stringify(users))
} catch (error) {
console.error('Error saving user:', error)
}
},
/**
* Clear all stored data (for testing/debugging)
*/
clearAll: async (): Promise<void> => {
try {
await AsyncStorage.multiRemove([CURRENT_USER_KEY, USERS_KEY])
} catch (error) {
console.error('Error clearing storage:', error)
}
},
}
src/styles/theme.ts
/**
* Theme constants for consistent styling across the app
* Matches the color scheme from the TanStack Start web version
*/
export const colors = {
// Primary colors
primary: '#0070f3',
primaryDark: '#0051cc',
// Status colors
success: '#28a745',
successDark: '#218838',
danger: '#dc3545',
dangerDark: '#c82333',
// Feature colors
burrito: '#e07c24',
burritoDark: '#c96a1a',
// Neutral colors
background: '#f5f5f5',
white: '#ffffff',
text: '#333333',
textSecondary: '#666666',
textLight: '#999999',
border: '#dddddd',
borderLight: '#eeeeee',
// Component-specific
statsBackground: '#f8f9fa',
headerBackground: '#333333',
headerText: '#ffffff',
inputBackground: '#ffffff',
cardBackground: '#ffffff',
}
export const spacing = {
xs: 4,
sm: 8,
md: 16,
lg: 24,
xl: 32,
xxl: 48,
}
export const typography = {
sizes: {
xs: 12,
sm: 14,
md: 16,
lg: 18,
xl: 24,
xxl: 32,
},
weights: {
normal: '400' as const,
medium: '500' as const,
semibold: '600' as const,
bold: '700' as const,
},
}
export const borderRadius = {
sm: 4,
md: 8,
lg: 12,
full: 9999,
}
export const shadows = {
sm: {
shadowColor: '#000',
shadowOffset: { width: 0, height: 1 },
shadowOpacity: 0.05,
shadowRadius: 2,
elevation: 1,
},
md: {
shadowColor: '#000',
shadowOffset: { width: 0, height: 2 },
shadowOpacity: 0.1,
shadowRadius: 4,
elevation: 3,
},
lg: {
shadowColor: '#000',
shadowOffset: { width: 0, height: 4 },
shadowOpacity: 0.15,
shadowRadius: 8,
elevation: 5,
},
}