references/EXAMPLE-react-native.md · 24000
e" color={colors.primary} /> ) }
return ( <Stack.Navigator screenOptions={{ headerStyle: { backgroundColor: colors.headerBackground, }, headerTintColor: colors.headerText, headerTitleStyle: { fontWeight: 'bold', }, headerBackTitleVisible: false, animation: 'slide_from_right', }} > <Stack.Screen name="Home" component={HomeScreen} options={{ title: 'Burrito App', }} /> <Stack.Screen name="Burrito" component={BurritoScreen} options={{ title: 'Burrito Consideration', }} /> <Stack.Screen name="Profile" component={ProfileScreen} options={{ title: 'Profile', }} /> </Stack.Navigator> ) }
const styles = StyleSheet.create({ loadingContainer: { flex: 1, justifyContent: 'center', alignItems: 'center', backgroundColor: colors.background, }, })
---
## src/screens/BurritoScreen.tsx
```tsx
import React, { useState, useEffect } from 'react'
import { View, Text, TouchableOpacity, StyleSheet } from 'react-native'
import { useNavigation } from '@react-navigation/native'
import { NativeStackNavigationProp } from '@react-navigation/native-stack'
import { usePostHog } from 'posthog-react-native'
import { useAuth } from '../contexts/AuthContext'
import { RootStackParamList } from '../navigation/RootNavigator'
import {
colors,
spacing,
typography,
borderRadius,
shadows,
} from '../styles/theme'
type BurritoScreenNavigationProp = NativeStackNavigationProp<
RootStackParamList,
'Burrito'
>
/**
* Burrito Consideration Screen
*
* Demonstrates PostHog event tracking with custom properties.
* Each time the user considers a burrito, an event is captured.
*
* @see https://posthog.com/docs/libraries/react-native#capturing-events
*/
export default function BurritoScreen() {
const { user, incrementBurritoConsiderations } = useAuth()
const navigation = useNavigation<BurritoScreenNavigationProp>()
const posthog = usePostHog()
const [hasConsidered, setHasConsidered] = useState(false)
// Redirect to home if not logged in
useEffect(() => {
if (!user) {
navigation.navigate('Home')
}
}, [user, navigation])
if (!user) {
return null
}
const handleConsideration = async () => {
const newCount = user.burritoConsiderations + 1
// Update state first for immediate feedback
await incrementBurritoConsiderations()
setHasConsidered(true)
// Hide success message after 2 seconds
setTimeout(() => setHasConsidered(false), 2000)
// Capture custom event in PostHog with properties
// We recommend using a [object] [verb] format for event names
// @see https://posthog.com/docs/libraries/react-native#capturing-events
posthog.capture('burrito_considered', {
total_considerations: newCount,
username: user.username,
})
}
return (
<View style={styles.container}>
<View style={styles.card}>
<Text style={styles.title}>Burrito Consideration Zone</Text>
<Text style={styles.text}>
Take a moment to truly consider the potential of burritos.
</Text>
{/*
testID is captured by PostHog autocapture for touch events
This helps identify the button in analytics
@see https://posthog.com/docs/libraries/react-native#autocapture
*/}
<TouchableOpacity
style={styles.burritoButton}
onPress={handleConsideration}
activeOpacity={0.8}
testID="consider-burrito-button"
>
<Text style={styles.burritoButtonText}>Consider Burrito</Text>
</TouchableOpacity>
{hasConsidered && (
<View style={styles.successContainer}>
<Text style={styles.success}>
Thank you for your consideration!
</Text>
<Text style={styles.successCount}>
Count: {user.burritoConsiderations}
</Text>
</View>
)}
<View style={styles.stats}>
<Text style={styles.statsTitle}>Consideration Stats</Text>
<Text style={styles.statsText}>
Total considerations: {user.burritoConsiderations}
</Text>
</View>
</View>
</View>
)
}
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.sm,
},
text: {
fontSize: typography.sizes.md,
color: colors.text,
marginBottom: spacing.lg,
lineHeight: 24,
},
burritoButton: {
backgroundColor: colors.burrito,
borderRadius: borderRadius.sm,
padding: spacing.lg,
alignItems: 'center',
marginVertical: spacing.md,
...shadows.sm,
},
burritoButtonText: {
color: colors.white,
fontSize: typography.sizes.lg,
fontWeight: typography.weights.bold,
},
successContainer: {
alignItems: 'center',
marginVertical: spacing.sm,
},
success: {
color: colors.success,
fontSize: typography.sizes.md,
fontWeight: typography.weights.medium,
},
successCount: {
color: colors.success,
fontSize: typography.sizes.lg,
fontWeight: typography.weights.bold,
marginTop: spacing.xs,
},
stats: {
backgroundColor: colors.statsBackground,
padding: spacing.md,
borderRadius: borderRadius.sm,
marginTop: spacing.lg,
},
statsTitle: {
fontSize: typography.sizes.lg,
fontWeight: typography.weights.semibold,
color: colors.text,
marginBottom: spacing.xs,
},
statsText: {
fontSize: typography.sizes.md,
color: colors.text,
},
})
src/screens/HomeScreen.tsx
import React, { useState } from 'react'
import {
View,
Text,
TextInput,
TouchableOpacity,
StyleSheet,
ScrollView,
KeyboardAvoidingView,
Platform,
} from 'react-native'
import { useNavigation } from '@react-navigation/native'
import { NativeStackNavigationProp } from '@react-navigation/native-stack'
import { useAuth } from '../contexts/AuthContext'
import { RootStackParamList } from '../navigation/RootNavigator'
import {
colors,
spacing,
typography,
borderRadius,
shadows,
} from '../styles/theme'
type HomeScreenNavigationProp = NativeStackNavigationProp<
RootStackParamList,
'Home'
>
export default function HomeScreen() {
const { user, login, logout } = useAuth()
const navigation = useNavigation<HomeScreenNavigationProp>()
const [username, setUsername] = useState('')
const [password, setPassword] = useState('')
const [error, setError] = useState('')
const [isSubmitting, setIsSubmitting] = useState(false)
const handleSubmit = async () => {
setError('')
if (!username.trim() || !password.trim()) {
setError('Please provide both username and password')
return
}
setIsSubmitting(true)
try {
const success = await login(username, password)
if (success) {
setUsername('')
setPassword('')
} else {
setError('An error occurred during login')
}
} catch {
setError('An error occurred during login')
} finally {
setIsSubmitting(false)
}
}
// Logged in view
if (user) {
return (
<ScrollView
style={styles.scrollView}
contentContainerStyle={styles.scrollContent}
>
<View style={styles.card}>
<Text style={styles.title}>Welcome back, {user.username}!</Text>
<Text style={styles.text}>
You are now logged in. Feel free to explore:
</Text>
<View style={styles.buttonGroup}>
<TouchableOpacity
style={[styles.button, styles.burritoButton]}
onPress={() => navigation.navigate('Burrito')}
activeOpacity={0.8}
>
<Text style={styles.buttonText}>Consider Burritos</Text>
</TouchableOpacity>
<TouchableOpacity
style={[styles.button, styles.primaryButton]}
onPress={() => navigation.navigate('Profile')}
activeOpacity={0.8}
>
<Text style={styles.buttonText}>View Profile</Text>
</TouchableOpacity>
<TouchableOpacity
style={[styles.button, styles.logoutButton]}
onPress={logout}
activeOpacity={0.8}
>
<Text style={styles.buttonText}>Logout</Text>
</TouchableOpacity>
</View>
</View>
</ScrollView>
)
}
// Login view
return (
<KeyboardAvoidingView
style={styles.container}
behavior={Platform.OS === 'ios' ? 'padding' : 'height'}
>
<ScrollView
style={styles.scrollView}
contentContainerStyle={styles.scrollContent}
keyboardShouldPersistTaps="handled"
>
<View style={styles.card}>
<Text style={styles.title}>Welcome to Burrito Consideration App</Text>
<Text style={styles.text}>
Please sign in to begin your burrito journey
</Text>
<View style={styles.form}>
<Text style={styles.label}>Username:</Text>
<TextInput
style={styles.input}
value={username}
onChangeText={setUsername}
placeholder="Enter any username"
placeholderTextColor={colors.textLight}
autoCapitalize="none"
autoCorrect={false}
autoComplete="username"
editable={!isSubmitting}
/>
<Text style={styles.label}>Password:</Text>
<TextInput
style={styles.input}
value={password}
onChangeText={setPassword}
placeholder="Enter any password"
placeholderTextColor={colors.textLight}
secureTextEntry
autoComplete="password"
editable={!isSubmitting}
/>
{error ? <Text style={styles.error}>{error}</Text> : null}
<TouchableOpacity
style={[
styles.button,
styles.primaryButton,
isSubmitting && styles.buttonDisabled,
]}
onPress={handleSubmit}
disabled={isSubmitting}
activeOpacity={0.8}
>
<Text style={styles.buttonText}>
{isSubmitting ? 'Signing In...' : 'Sign In'}
</Text>
</TouchableOpacity>
</View>
<Text style={styles.note}>
Note: This is a demo app. Use any username and password to sign in.
</Text>
</View>
</ScrollView>
</KeyboardAvoidingView>
)
}
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: colors.background,
},
scrollView: {
flex: 1,
backgroundColor: colors.background,
},
scrollContent: {
flexGrow: 1,
padding: spacing.md,
justifyContent: 'center',
},
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.sm,
},
text: {
fontSize: typography.sizes.md,
color: colors.text,
marginBottom: spacing.md,
lineHeight: 24,
},
form: {
marginTop: spacing.md,
},
label: {
fontSize: typography.sizes.md,
fontWeight: typography.weights.medium,
color: colors.text,
marginBottom: spacing.xs,
},
input: {
backgroundColor: colors.inputBackground,
borderWidth: 1,
borderColor: colors.border,
borderRadius: borderRadius.sm,
padding: spacing.sm,
fontSize: typography.sizes.md,
color: colors.text,
marginBottom: spacing.md,
},
buttonGroup: {
marginTop: spacing.md,
gap: spacing.sm,
},
button: {
borderRadius: borderRadius.sm,
padding: spacing.md,
alignItems: 'center',
marginTop: spacing.sm,
},
primaryButton: {
backgroundColor: colors.primary,
},
burritoButton: {
backgroundColor: colors.burrito,
},
logoutButton: {
backgroundColor: colors.danger,
},
buttonDisabled: {
opacity: 0.6,
},
buttonText: {
color: colors.white,
fontSize: typography.sizes.md,
fontWeight: typography.weights.semibold,
},
error: {
color: colors.danger,
marginBottom: spacing.sm,
fontSize: typography.sizes.sm,
},
note: {
marginTop: spacing.lg,
color: colors.textSecondary,
fontSize: typography.sizes.sm,
textAlign: 'center',
lineHeight: 20,
},
})
src/screens/ProfileScreen.tsx
import React, { useEffect } from 'react'
import { View, Text, TouchableOpacity, StyleSheet, Alert } from 'react-native'
import { useNavigation } from '@react-navigation/native'
import { NativeStackNavigationProp } from '@react-navigation/native-stack'
import { usePostHog } from 'posthog-react-native'
import { useAuth } from '../contexts/AuthContext'
import { RootStackParamList } from '../navigation/RootNavigator'
import {
colors,
spacing,
typography,
borderRadius,
shadows,
} from '../styles/theme'
type ProfileScreenNavigationProp = NativeStackNavigationProp<
RootStackParamList,
'Profile'
>
/**
* Profile Screen
*
* Displays user information and demonstrates PostHog error tracking.
* The test error button shows how to capture exceptions manually.
*
* @see https://posthog.com/docs/libraries/react-native#error-tracking
*/
export default function ProfileScreen() {
const { user } = useAuth()
const navigation = useNavigation<ProfileScreenNavigationProp>()
const posthog = usePostHog()
// Redirect to home if not logged in
useEffect(() => {
if (!user) {
navigation.navigate('Home')
}
}, [user, navigation])
if (!user) {
return null
}
/**
* Triggers a test error and captures it in PostHog
*
* This demonstrates manual exception capture using the $exception event.
* In production, you would typically set up automatic exception capture
* or use the before_send callback for customization.
*
* @see https://posthog.com/docs/libraries/react-native#error-tracking
*/
const triggerTestError = () => {
try {
throw new Error('Test error for PostHog error tracking')
} catch (err) {
const error = err as Error
// Capture exception in PostHog using the $exception event
// This follows PostHog's error tracking format
posthog.capture('$exception', {
$exception_type: error.name,
$exception_message: error.message,
$exception_source: 'ProfileScreen.triggerTestError',
$exception_stack_trace_raw: error.stack,
// Additional context
username: user.username,
screen: 'Profile',
})
console.error('Captured error:', error)
Alert.alert(
'Error Captured',
'The test error has been sent to PostHog!',
[{ text: 'OK' }],
)
}
}
const getJourneyMessage = () => {
const count = user.burritoConsiderations
if (count === 0) {
return "You haven't considered any burritos yet. Visit the Burrito Consideration page to start!"
} else if (count === 1) {
return "You've considered the burrito potential once. Keep going!"
} else if (count < 5) {
return "You're getting the hang of burrito consideration!"
} else if (count < 10) {
return "You're becoming a burrito consideration expert!"
} else {
return 'You are a true burrito consideration master!'
}
}
return (
<View style={styles.container}>
<View style={styles.card}>
<Text style={styles.title}>User Profile</Text>
<View style={styles.stats}>
<Text style={styles.statsTitle}>Your Information</Text>
<View style={styles.infoRow}>
<Text style={styles.infoLabel}>Username:</Text>
<Text style={styles.infoValue}>{user.username}</Text>
</View>
<View style={styles.infoRow}>
<Text style={styles.infoLabel}>Burrito Considerations:</Text>
<Text style={styles.infoValue}>{user.burritoConsiderations}</Text>
</View>
</View>
{/*
testID is captured by PostHog autocapture for touch events
@see https://posthog.com/docs/libraries/react-native#autocapture
*/}
<TouchableOpacity
style={styles.errorButton}
onPress={triggerTestError}
activeOpacity={0.8}
testID="trigger-error-button"
>
<Text style={styles.buttonText}>Trigger Test Error (for PostHog)</Text>
</TouchableOpacity>
<View style={styles.journey}>
<Text style={styles.journeyTitle}>Your Burrito Journey</Text>
<Text style={styles.journeyText}>{getJourneyMessage()}</Text>
</View>
</View>
</View>
)
}
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,
},
})
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,
},
}
src/types/env.d.ts
declare module 'react-native-config' {
export interface NativeConfig {
POSTHOG_PROJECT_TOKEN?: string
POSTHOG_HOST?: string
}
export const Config: NativeConfig
export default Config
}