Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.
Add mobile app developer tools
Leendert de Borst1ed34273ff70
diff --git a/apps/mobile-app/app/(tabs)/settings/_layout.tsx b/apps/mobile-app/app/(tabs)/settings/_layout.tsxindex 83c31f4fd..d2f1e918a 100644--- a/apps/mobile-app/app/(tabs)/settings/_layout.tsx+++ b/apps/mobile-app/app/(tabs)/settings/_layout.tsx@@ -135,6 +135,15 @@ export default function SettingsLayout(): React.ReactNode {...defaultHeaderOptions,}}/>+ {/* Developer only screen. Note: not required to be translated. */}+ <Stack.Screen+ name="developer-tools"+ options={{+ title: 'Developer tools',+ headerBackTitle: t('settings.title'),+ ...defaultHeaderOptions,+ }}+ /><Stack.Screenname="qr-scanner"options={{diff --git a/apps/mobile-app/app/(tabs)/settings/developer-tools.tsx b/apps/mobile-app/app/(tabs)/settings/developer-tools.tsxnew file mode 100644index 000000000..5d05a0b7d--- /dev/null+++ b/apps/mobile-app/app/(tabs)/settings/developer-tools.tsx@@ -0,0 +1,211 @@+import { Ionicons } from '@expo/vector-icons';+import { router, useFocusEffect } from 'expo-router';+import { useCallback, useState } from 'react';+import { StyleSheet, View } from 'react-native';+import Toast from 'react-native-toast-message';++import { useColors } from '@/hooks/useColorScheme';++import { ThemedButton } from '@/components/themed/ThemedButton';+import { ThemedContainer } from '@/components/themed/ThemedContainer';+import { ThemedScrollView } from '@/components/themed/ThemedScrollView';+import { ThemedText } from '@/components/themed/ThemedText';+import { AppReviewService, type AppReviewState } from '@/services/AppReviewService';+import { DeveloperToolsService } from '@/services/DeveloperToolsService';++/**+ * Row in one of the state readouts below.+ */+type StateRow = {+ label: string;+ value: string;+ met?: boolean;+};++/**+ * Developer tools screen. Note: not required to be translated.+ */+export default function DeveloperToolsScreen(): React.ReactNode {+ const colors = useColors();+ const [reviewState, setReviewState] = useState<AppReviewState | null>(null);++ const loadReviewState = useCallback(async (): Promise<void> => {+ setReviewState(await AppReviewService.getState());+ }, []);++ useFocusEffect(+ useCallback(() => {+ loadReviewState();+ }, [loadReviewState])+ );++ /**+ * Ask the OS for its review prompt right now, skipping every condition.+ */+ const handleRequestReview = useCallback(async (): Promise<void> => {+ const requested = await AppReviewService.requestReviewNow();+ }, []);++ /**+ * Forget the recorded uses and asks, as if the app was freshly installed.+ */+ const handleResetReviewState = useCallback(async (): Promise<void> => {+ await AppReviewService.reset();+ await loadReviewState();++ Toast.show({+ type: 'success',+ text1: 'App review state reset',+ position: 'bottom',+ visibilityTime: 2000,+ });+ }, [loadReviewState]);++ /**+ * Hide the developer tools again, which also puts the unlock gesture back at the start. Useful+ * to get the app into a clean state for app store screenshots.+ */+ const handleHideDeveloperTools = useCallback(async (): Promise<void> => {+ await DeveloperToolsService.setEnabled(false);+ router.back();+ }, []);++ const reviewRows: StateRow[] = reviewState ? [+ {+ label: 'Review prompt available',+ value: reviewState.isAvailable ? 'Yes' : 'No',+ met: reviewState.isAvailable,+ },+ {+ label: 'Days installed',+ value: `${reviewState.daysInstalled} of ${reviewState.minDaysInstalled}`,+ met: reviewState.daysInstalled >= reviewState.minDaysInstalled,+ },+ {+ label: 'Successful uses',+ value: `${reviewState.useCount} of ${reviewState.minUseCount}`,+ met: reviewState.useCount >= reviewState.minUseCount,+ },+ {+ label: 'Days since last ask',+ value: reviewState.daysSinceLastPrompt === null+ ? 'Never asked'+ : `${reviewState.daysSinceLastPrompt} of ${reviewState.minDaysBetweenPrompts}`,+ met: reviewState.daysSinceLastPrompt === null+ || reviewState.daysSinceLastPrompt >= reviewState.minDaysBetweenPrompts,+ },+ {+ label: 'Asked for this version',+ value: reviewState.lastPromptVersion ?? 'Never asked',+ met: reviewState.lastPromptVersion !== reviewState.currentVersion,+ },+ {+ label: 'Would ask on next vault open',+ value: reviewState.meetsCriteria ? 'Yes' : 'No',+ met: reviewState.meetsCriteria,+ },+ ] : [];++ const styles = StyleSheet.create({+ button: {+ marginTop: 12,+ backgroundColor: colors.primary,+ },+ buttonSecondary: {+ marginTop: 12,+ backgroundColor: colors.accentBackground,+ },+ headerText: {+ color: colors.textMuted,+ fontSize: 13,+ lineHeight: 20,+ },+ row: {+ alignItems: 'center',+ borderBottomColor: colors.accentBorder,+ borderBottomWidth: StyleSheet.hairlineWidth,+ flexDirection: 'row',+ paddingHorizontal: 16,+ paddingVertical: 12,+ },+ rowLabel: {+ color: colors.text,+ flex: 1,+ fontSize: 15,+ },+ rowLast: {+ borderBottomWidth: 0,+ },+ rowStatusIcon: {+ marginLeft: 8,+ },+ rowValue: {+ color: colors.textMuted,+ flexShrink: 1,+ fontSize: 15,+ textAlign: 'right',+ },+ section: {+ backgroundColor: colors.accentBackground,+ borderRadius: 10,+ marginTop: 8,+ overflow: 'hidden',+ },+ sectionTitle: {+ color: colors.textMuted,+ fontSize: 13,+ fontWeight: '600',+ marginTop: 24,+ textTransform: 'uppercase',+ },+ });++ return (+ <ThemedContainer>+ <ThemedScrollView>+ <ThemedText style={styles.headerText}>+ These tools are for development and manual testing purposes.+ </ThemedText>++ <ThemedText style={styles.sectionTitle}>App store review</ThemedText>+ {reviewRows.length > 0 && (+ <View style={styles.section}>+ {reviewRows.map((row, index) => (+ <View+ key={row.label}+ style={[styles.row, index === reviewRows.length - 1 && styles.rowLast]}+ >+ <ThemedText style={styles.rowLabel}>{row.label}</ThemedText>+ <ThemedText style={styles.rowValue}>{row.value}</ThemedText>+ <Ionicons+ name={row.met ? 'checkmark-circle' : 'close-circle'}+ size={18}+ color={row.met ? colors.primary : colors.textMuted}+ style={styles.rowStatusIcon}+ />+ </View>+ ))}+ </View>+ )}++ <ThemedButton+ style={styles.button}+ title="Trigger review prompt now"+ onPress={handleRequestReview}+ />+ <ThemedButton+ style={styles.buttonSecondary}+ title="Reset app review state"+ onPress={handleResetReviewState}+ />++ <ThemedText style={styles.sectionTitle}>Developer tools</ThemedText>+ <ThemedButton+ style={styles.buttonSecondary}+ title="Hide developer tools"+ onPress={handleHideDeveloperTools}+ />+ </ThemedScrollView>+ </ThemedContainer>+ );+}diff --git a/apps/mobile-app/app/(tabs)/settings/index.tsx b/apps/mobile-app/app/(tabs)/settings/index.tsxindex fe2f04876..bea3d5a46 100644--- a/apps/mobile-app/app/(tabs)/settings/index.tsx+++ b/apps/mobile-app/app/(tabs)/settings/index.tsx@@ -1,6 +1,6 @@import { Ionicons } from '@expo/vector-icons';-import { router, useFocusEffect } from 'expo-router';-import { useRef, useState, useCallback } from 'react';+import { router, useFocusEffect, useNavigation } from 'expo-router';+import { useEffect, useRef, useState, useCallback } from 'react';import { StyleSheet, View, ScrollView, TouchableOpacity, Animated, Platform, Linking } from 'react-native';import { useSafeAreaInsets } from 'react-native-safe-area-context';@@ -9,6 +9,7 @@ import { AppInfo } from '@/utils/AppInfo';import { AppUnlockUtility } from '@/utils/AppUnlockUtility';import { useColors } from '@/hooks/useColorScheme';+import { useDeveloperToolsUnlock } from '@/hooks/useDeveloperToolsUnlock';import { useLogout } from '@/hooks/useLogout';import { useMinDurationLoading } from '@/hooks/useMinDurationLoading';import { useNavigationDebounce } from '@/hooks/useNavigationDebounce';@@ -16,6 +17,7 @@ import { useTranslation } from '@/hooks/useTranslation';import { ThemedContainer } from '@/components/themed/ThemedContainer';import { ThemedText } from '@/components/themed/ThemedText';+import { AndroidHeader } from '@/components/ui/AndroidHeader';import { CollapsibleHeader } from '@/components/ui/CollapsibleHeader';import { InlineSkeletonLoader } from '@/components/ui/InlineSkeletonLoader';import { TitleContainer } from '@/components/ui/TitleContainer';@@ -38,6 +40,7 @@ export default function SettingsScreen() : React.ReactNode {const { logoutUserInitiated } = useLogout();const { loadApiUrl, getDisplayUrl } = useApiUrl();const navigate = useNavigationDebounce();+ const navigation = useNavigation();const [scrollY] = useState(() => new Animated.Value(0));const scrollViewRef = useRef<ScrollView>(null);const [autoLockDisplay, setAutoLockDisplay] = useState<string>('');@@ -45,6 +48,7 @@ export default function SettingsScreen() : React.ReactNode {const [authMethodDisplay, setAuthMethodDisplay] = useState<string>('');const [serverVersion, setServerVersion] = useState<string | null>(null);const [isFirstLoad, setIsFirstLoad] = useMinDurationLoading(true, 100);+ const { isEnabled: isDeveloperToolsEnabled, registerTap, refresh: refreshDeveloperTools } = useDeveloperToolsUnlock();useFocusEffect(useCallback(() => {@@ -127,9 +131,30 @@ export default function SettingsScreen() : React.ReactNode {};loadData();- }, [getAutoLockTimeout, setIsFirstLoad, loadApiUrl, t])+ refreshDeveloperTools();+ }, [getAutoLockTimeout, setIsFirstLoad, loadApiUrl, refreshDeveloperTools, t]));+ /*+ * Replace the header declared in the settings layout, so the logo can carry the hidden+ * developer tools unlock gesture. Android only, on iOS the TitleContainer logo carries it.+ */+ useEffect(() => {+ if (Platform.OS !== 'android') {+ return;+ }++ navigation.setOptions({+ /**+ * Define the custom Android header, matching the one in the settings layout.+ * @returns {React.ReactNode} The header component+ */+ headerTitle: (): React.ReactNode => (+ <AndroidHeader title={t('settings.title')} onLogoPress={registerTap} />+ ),+ });+ }, [navigation, registerTap, t]);+/*** Handle the vault unlock press.*/@@ -297,6 +322,11 @@ export default function SettingsScreen() : React.ReactNode {flex: 1,fontSize: 16,},+ settingItemTextDeveloper: {+ color: colors.red,+ flex: 1,+ fontSize: 16,+ },settingItemValue: {color: colors.textMuted,flexShrink: 1,@@ -346,7 +376,7 @@ export default function SettingsScreen() : React.ReactNode {scrollIndicatorInsets={{ bottom: 40 }}style={styles.scrollView}>- <TitleContainer title={t('settings.title')} />+ <TitleContainer title={t('settings.title')} onLogoPress={registerTap} /><UsernameDisplay /><View style={styles.section}>{Platform.OS === 'ios' && (@@ -516,6 +546,24 @@ export default function SettingsScreen() : React.ReactNode {</TouchableOpacity></View>+ {isDeveloperToolsEnabled && (+ <View style={styles.section}>+ {/* Note: developer only screen, not required to be translated */}+ <TouchableOpacity+ style={styles.settingItem}+ onPress={() => navigate(() => router.push('/(tabs)/settings/developer-tools'))}+ >+ <View style={styles.settingItemIcon}>+ <Ionicons name="code-slash" size={20} color={colors.red} />+ </View>+ <View style={styles.settingItemContent}>+ <ThemedText style={styles.settingItemTextDeveloper}>Developer tools</ThemedText>+ <Ionicons name="chevron-forward" size={20} color={colors.textMuted} />+ </View>+ </TouchableOpacity>+ </View>+ )}+<View style={styles.section}><TouchableOpacitystyle={styles.settingItem}@@ -530,7 +578,7 @@ export default function SettingsScreen() : React.ReactNode {</TouchableOpacity></View>- <View style={styles.versionContainer}>+ <TouchableOpacity style={styles.versionContainer} onPress={registerTap} activeOpacity={1}><ThemedText style={styles.versionText}><ThemedText style={styles.versionLabel}>{t('settings.appVersion')}:</ThemedText> {AppInfo.VERSION}</ThemedText>@@ -539,7 +587,7 @@ export default function SettingsScreen() : React.ReactNode {<ThemedText style={styles.versionLabel}>{t('settings.serverVersion')}:</ThemedText> {serverVersion} ({getDisplayUrl()})</ThemedText>)}- </View>+ </TouchableOpacity></Animated.ScrollView>{/* Floating Action Button for QR Scanner - shown for testing both options */}diff --git a/apps/mobile-app/components/ui/AndroidHeader.tsx b/apps/mobile-app/components/ui/AndroidHeader.tsxindex 93911188c..854f80e3e 100644--- a/apps/mobile-app/components/ui/AndroidHeader.tsx+++ b/apps/mobile-app/components/ui/AndroidHeader.tsx@@ -15,12 +15,10 @@ type HeaderButton = {interface IAndroidHeaderProps {title: string;headerButtons?: HeaderButton[];- /** Optional callback when title is pressed (enables dropdown mode) */onTitlePress?: () => void;- /** Show dropdown arrow expanded state */isDropdownOpen?: boolean;- /** Optional subtitle shown next to title (e.g., item count) */subtitle?: string;+ onLogoPress?: () => void;}/**@@ -28,7 +26,7 @@ interface IAndroidHeaderProps {* @param {IAndroidHeaderProps} props - The component props* @returns {React.ReactNode} The Android header component*/-export function AndroidHeader({ title, headerButtons = [], onTitlePress, isDropdownOpen, subtitle }: IAndroidHeaderProps): React.ReactNode {+export function AndroidHeader({ title, headerButtons = [], onTitlePress, isDropdownOpen, subtitle, onLogoPress }: IAndroidHeaderProps): React.ReactNode {const colors = useColors();const styles = StyleSheet.create({@@ -102,7 +100,13 @@ export function AndroidHeader({ title, headerButtons = [], onTitlePress, isDropd/></Pressable>)}- <Logo width={40} height={40} style={styles.logo} />+ {onLogoPress ? (+ <Pressable onPress={onLogoPress}>+ <Logo width={40} height={40} style={styles.logo} />+ </Pressable>+ ) : (+ <Logo width={40} height={40} style={styles.logo} />+ )}{onTitlePress ? (<PressableonPress={onTitlePress}diff --git a/apps/mobile-app/components/ui/TitleContainer.tsx b/apps/mobile-app/components/ui/TitleContainer.tsxindex 36f0bffc0..6a69e051d 100644--- a/apps/mobile-app/components/ui/TitleContainer.tsx+++ b/apps/mobile-app/components/ui/TitleContainer.tsx@@ -1,4 +1,4 @@-import { Platform, StyleSheet, View } from 'react-native';+import { Platform, StyleSheet, TouchableOpacity, View } from 'react-native';import Logo from '@/assets/images/logo.svg';import { ThemedText } from '@/components/themed/ThemedText';@@ -6,13 +6,13 @@ import { ThemedText } from '@/components/themed/ThemedText';type TitleContainerProps = {title: string;showLogo?: boolean;+ onLogoPress?: () => void;};/*** Title container component.- * Note: Offline/sync status is now shown via the floating ServerSyncIndicator in the tab layout.*/-export function TitleContainer({ title, showLogo = true }: TitleContainerProps): React.ReactNode {+export function TitleContainer({ title, showLogo = true, onLogoPress }: TitleContainerProps): React.ReactNode {// On Android, we don't show the title container as the native header is usedif (Platform.OS === 'android') {return null;@@ -20,7 +20,15 @@ export function TitleContainer({ title, showLogo = true }: TitleContainerProps):return (<View style={styles.titleContainer}>- {showLogo && <Logo width={40} height={40} style={styles.logo} />}+ {showLogo && (+ onLogoPress ? (+ <TouchableOpacity onPress={onLogoPress} activeOpacity={1}>+ <Logo width={40} height={40} style={styles.logo} />+ </TouchableOpacity>+ ) : (+ <Logo width={40} height={40} style={styles.logo} />+ )+ )}<ThemedText type="title">{title}</ThemedText></View>);diff --git a/apps/mobile-app/hooks/useDeveloperToolsUnlock.ts b/apps/mobile-app/hooks/useDeveloperToolsUnlock.tsnew file mode 100644index 000000000..19f4c1539--- /dev/null+++ b/apps/mobile-app/hooks/useDeveloperToolsUnlock.ts@@ -0,0 +1,77 @@+import { useCallback, useEffect, useRef, useState } from 'react';+import Toast from 'react-native-toast-message';++import { DeveloperToolsService } from '@/services/DeveloperToolsService';++/**+ * Taps needed on the settings logo or version footer to reveal the developer tools.+ */+const REQUIRED_TAPS = 20;++/**+ * How long a tap sequence stays alive.+ */+const TAP_TIMEOUT_MS = 3000;++type DeveloperToolsUnlock = {+ isEnabled: boolean;+ registerTap: () => void;+ refresh: () => void;+};++/**+ * Hook that reveals the hidden developer tools after tapping an unlock target often enough.+ */+export function useDeveloperToolsUnlock(): DeveloperToolsUnlock {+ const [isEnabled, setIsEnabled] = useState(false);+ const tapCount = useRef(0);+ const resetTimer = useRef<ReturnType<typeof setTimeout> | null>(null);++ const refresh = useCallback((): void => {+ DeveloperToolsService.isEnabled().then(setIsEnabled);+ }, []);++ useEffect(() => {+ refresh();++ return (): void => {+ if (resetTimer.current) {+ clearTimeout(resetTimer.current);+ }+ };+ }, [refresh]);++ const registerTap = useCallback((): void => {+ if (isEnabled) {+ return;+ }++ if (resetTimer.current) {+ clearTimeout(resetTimer.current);+ }+ resetTimer.current = setTimeout(() => {+ tapCount.current = 0;+ }, TAP_TIMEOUT_MS);++ tapCount.current += 1;+ const tapsLeft = REQUIRED_TAPS - tapCount.current;++ if (tapsLeft > 0) {+ return;+ }++ tapCount.current = 0;++ DeveloperToolsService.setEnabled(true).then(() => {+ setIsEnabled(true);+ Toast.show({+ type: 'success',+ text1: 'Developer tools enabled',+ position: 'bottom',+ visibilityTime: 2000,+ });+ });+ }, [isEnabled]);++ return { isEnabled, registerTap, refresh };+}diff --git a/apps/mobile-app/services/DeveloperToolsService.ts b/apps/mobile-app/services/DeveloperToolsService.tsnew file mode 100644index 000000000..186ddc1f2--- /dev/null+++ b/apps/mobile-app/services/DeveloperToolsService.ts@@ -0,0 +1,34 @@+import AsyncStorage from '@react-native-async-storage/async-storage';++/**+ * Storage key for the developer tools toggle.+ */+const KEY = 'developer_tools_enabled';++/**+ * Service that tracks whether the hidden developer tools screen is reachable.+ */+export const DeveloperToolsService = {+ /**+ * Whether the developer tools should be shown in the settings list.+ */+ async isEnabled(): Promise<boolean> {+ try {+ return await AsyncStorage.getItem(KEY) === 'true';+ } catch (error) {+ console.error('Failed to read developer tools state:', error);+ return false;+ }+ },++ /**+ * Show or hide the developer tools.+ */+ async setEnabled(enabled: boolean): Promise<void> {+ try {+ await AsyncStorage.setItem(KEY, enabled.toString());+ } catch (error) {+ console.error('Failed to store developer tools state:', error);+ }+ },+};