Skip to content

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.tsx
index 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.Screen
name="qr-scanner"
options={{
diff --git a/apps/mobile-app/app/(tabs)/settings/developer-tools.tsx b/apps/mobile-app/app/(tabs)/settings/developer-tools.tsx
new file mode 100644
index 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.tsx
index 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}>
<TouchableOpacity
style={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.tsx
index 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 ? (
<Pressable
onPress={onTitlePress}
diff --git a/apps/mobile-app/components/ui/TitleContainer.tsx b/apps/mobile-app/components/ui/TitleContainer.tsx
index 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 used
if (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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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);
+ }
+ },
+};