Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(mobile): correct teammate navigation and list presentation (#4912)

Chris Zhang71514f441218
diff --git a/apps/mobile/src/__tests__/CompanionHeaderNavigation.test.tsx b/apps/mobile/src/__tests__/CompanionHeaderNavigation.test.tsx
index 87b13e23fe..b9b82806d4 100644
--- a/apps/mobile/src/__tests__/CompanionHeaderNavigation.test.tsx
+++ b/apps/mobile/src/__tests__/CompanionHeaderNavigation.test.tsx
@@ -107,6 +107,15 @@ it('preserves search, mode switching, account switching and logout actions', asy
await act(async () => h.drawer.onLogout()); expect(h.auth.logout).toHaveBeenCalledOnce();
});
+it('returns to the roster when the already-active companion mode is selected', async () => {
+ const onClose = vi.fn();
+ await act(async () => root.render(<CompanionNavigationDrawer open onClose={onClose} onSearch={() => {}} />));
+ await act(async () => h.drawer.onModeChange('teammates'));
+ expect(onClose).toHaveBeenCalledOnce(); expect(h.chooseMode).not.toHaveBeenCalled();
+ await act(async () => h.drawer.onClosed());
+ expect(h.chooseMode).toHaveBeenCalledExactlyOnceWith('teammates');
+});
+
it.each(['account', 'companion'])('drops a queued navigation action when the %s scope changes', async (change) => {
const render = (scope: string) => act(async () => root.render(<CompanionNavigationDrawer key={scope} open onClose={() => {}} onSearch={() => {}} />));
await render('old');
diff --git a/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx b/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx
index 810204db69..84e0bd8e05 100644
--- a/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx
+++ b/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx
@@ -5,10 +5,11 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import type { HomeMode, LastTeammateIdentity } from '@/session/homeViewPreferenceStore';
import type { HostedRemoteCollectionItem } from '@/device-link/remoteResources';
const h = vi.hoisted(() => ({
+ realNavigation: false, stored: null as string | null, tasks: {} as any, dismissTo: vi.fn(),
focused: true, drawer: {} as any, list: {} as any, accounts: {} as any, push: vi.fn(),
auth: { user: { id: 'owner' }, accountGeneration: 1, logout: vi.fn(), beginAddAccount: vi.fn() },
nav: { hydrated: true, lastTeammate: null as LastTeammateIdentity | null, mode: 'teammates' as HomeMode,
- saveFailed: false, openTeammate: vi.fn(), rememberTeammate: vi.fn(), setMode: vi.fn() },
+ restoreLastTeammate: true, saveFailed: false, openTeammate: vi.fn(), rememberTeammate: vi.fn(), setMode: vi.fn() },
roster: { createTargets: [], authoritative: true, items: [] as HostedRemoteCollectionItem[], loading: false, refreshing: false, error: null as string | null,
isOnline: vi.fn(() => true), refresh: vi.fn() },
}));
@@ -17,9 +18,9 @@ vi.mock('react-native', async () => {
return { View: ({ children }: any) => el('div', {}, children), ActivityIndicator: () => null,
Keyboard: { dismiss() {} }, Alert: { alert: vi.fn() }, StyleSheet: { create: (value: unknown) => value } };
});
-vi.mock('expo-router', () => ({ Stack: { Screen: () => null }, useIsFocused: () => h.focused }));
+vi.mock('expo-router', () => ({ Stack: { Screen: () => null }, useIsFocused: () => h.focused, useRouter: () => ({ dismissTo: h.dismissTo }) }));
vi.mock('react-native-safe-area-context', () => ({ SafeAreaView: 'div' }));
-vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key }) }));
+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key, i18n: { language: 'en' } }) }));
vi.mock('lucide-react-native', () => ({ Menu: () => null }));
vi.mock('@/components/AppText', () => ({ Text: 'span' }));
vi.mock('@/auth/AuthContext', () => ({ useAuth: () => h.auth }));
@@ -32,8 +33,16 @@ vi.mock('@/session/AccountSwitcherSheet', () => ({ AccountSwitcherSheet: (props:
vi.mock('@/session/HomeHeaderGlassButton', () => ({ HomeHeaderGlassButton: () => null }));
vi.mock('@/session/TeammateList', () => ({ TeammateList: (props: unknown) => { h.list = props; return null; } }));
vi.mock('@/session/useTeammateRoster', () => ({ useTeammateRoster: () => ({ ...h.roster }) }));
-vi.mock('@/session/useTeammateNavigation', () => ({ useTeammateNavigation: () => ({ ...h.nav }) }));
+vi.mock('@/session/useTeammateNavigation', async original => {
+ const actual = await original<typeof import('@/session/useTeammateNavigation')>();
+ return { useTeammateNavigation: () => h.realNavigation ? actual.useTeammateNavigation() : { ...h.nav } };
+});
+vi.mock('@react-native-async-storage/async-storage', () => ({ default: {
+ getItem: async () => h.stored, setItem: async (_key: string, value: string) => { h.stored = value; },
+} }));
+vi.mock('@/session/HomeSurface', () => ({ MobileHome: (props: unknown) => { h.tasks = props; return null; } }));
vi.mock('@/session/remoteSessionStore', () => ({ remoteSessionStore: { subscribe: () => () => {}, getSessions: () => [] } }));
+import HomeScreen from '../../app/devices/index';
import { TeammateHomeScreen } from '@/session/TeammateHomeScreen';
import { teammateIdentity } from '@/session/teammateNavigation';
Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
@@ -41,7 +50,10 @@ const teammate: HostedRemoteCollectionItem = { key: 'mac:bot', host: { deviceId:
item: { ref: { collectionId: 'teammates', kind: 'bot', id: 'writer' }, revision: '1', display: { title: 'Writer' }, links: [] } };
let root: Root | undefined;
async function render() { root ??= createRoot(document.createElement('div')); await act(async () => root!.render(createElement(TeammateHomeScreen))); }
+let serial = 0;
beforeEach(() => {
+ h.realNavigation = false; h.stored = null; h.nav.restoreLastTeammate = true;
+ h.auth.user = { id: `owner-${++serial}` }; h.auth.accountGeneration = serial;
vi.clearAllMocks(); h.focused = true; h.nav.lastTeammate = teammateIdentity(teammate); h.roster.items = [teammate];
h.nav.mode = 'teammates'; h.roster.authoritative = true;
h.roster.loading = false; h.roster.error = null; h.roster.isOnline.mockReturnValue(true);
@@ -92,3 +104,39 @@ describe('teammate home entry', () => {
h.auth.logout.mockResolvedValue(undefined); await act(async () => h.drawer.onLogout()); expect(h.auth.logout).toHaveBeenCalledOnce();
});
});
+
+// Exercise the real page, shared preferences, mode panes and navigation together.
+// Only native chrome, list rendering, storage and the router boundary are replaced.
+describe('explicit sidebar entry through the home page', () => {
+ async function renderHome() {
+ root ??= createRoot(document.createElement('div'));
+ await act(async () => root!.render(createElement(HomeScreen)));
+ }
+ it.each([1, 2])('keeps a %i-companion roster open across refresh and remount until a row is chosen', async count => {
+ h.realNavigation = true;
+ h.stored = JSON.stringify({ mode: 'tasks', lastTeammate: teammateIdentity(teammate) });
+ const second = { ...teammate, key: 'mac:second', item: { ...teammate.item, ref: { ...teammate.item.ref, id: 'second' } } };
+ const items = count === 1 ? [teammate] : [teammate, second];
+ h.roster.items = []; h.roster.loading = true;
+ await renderHome();
+ await act(async () => h.tasks.onModeChange('teammates'));
+ h.roster.items = items; h.roster.loading = false;
+ await renderHome();
+ expect(h.push).not.toHaveBeenCalled();
+ expect(h.list.items).toEqual(items);
+ await act(async () => h.list.onRefresh()); await renderHome();
+ act(() => root!.unmount()); root = undefined;
+ await renderHome();
+ expect(h.push).not.toHaveBeenCalled();
+ await act(async () => h.list.onSelect(items.at(-1)));
+ expect(h.push).toHaveBeenCalledOnce();
+ expect(h.push.mock.calls[0][0].params.resourceId).toBe(items.at(-1)!.item.ref.id);
+ });
+ it('still restores the last companion on an untouched cold startup', async () => {
+ h.realNavigation = true;
+ h.stored = JSON.stringify({ mode: 'teammates', lastTeammate: teammateIdentity(teammate) });
+ await renderHome();
+ expect(h.push).toHaveBeenCalledOnce();
+ expect(h.push.mock.calls[0][0].params.resourceId).toBe('writer');
+ });
+});
diff --git a/apps/mobile/src/__tests__/useTeammateNavigation.test.tsx b/apps/mobile/src/__tests__/useTeammateNavigation.test.tsx
index 216bbc5d07..4dc855ce5f 100644
--- a/apps/mobile/src/__tests__/useTeammateNavigation.test.tsx
+++ b/apps/mobile/src/__tests__/useTeammateNavigation.test.tsx
@@ -39,7 +39,9 @@ describe('header/home shared navigation', () => {
const owner = homeNavigationOwner(h.user);
await saveHomeNavigationPreferences(owner, { mode: 'teammates', lastTeammate: teammateIdentity(teammate) });
await render(); expect(result.mode).toBe('teammates'); expect(result.lastTeammate?.resourceId).toBe('writer');
+ expect(result.restoreLastTeammate).toBe(true);
await act(async () => result.chooseMode('tasks'));
+ expect(result.restoreLastTeammate).toBe(false);
expect(h.dismissTo).toHaveBeenCalledWith('/devices');
expect(await readHomeNavigationPreferences(owner)).toEqual({ mode: 'tasks', lastTeammate: teammateIdentity(teammate) });
});
@@ -104,8 +106,11 @@ describe('header/home shared navigation', () => {
await render();
let change!: Promise<void>;
await act(async () => { change = result.setMode('teammates'); });
+ expect(result.hydrated).toBe(false);
+ expect(result.restoreLastTeammate).toBe(false);
await act(async () => { finish(JSON.stringify({ mode: 'tasks', lastTeammate: teammateIdentity(teammate) })); await change; });
expect(result.mode).toBe('teammates'); expect(result.lastTeammate).toEqual(teammateIdentity(teammate));
+ expect(result.restoreLastTeammate).toBe(false);
});
it('does not let a hung preference read blank home forever or a late mode hijack the fallback task list', async () => {
vi.useFakeTimers();
diff --git a/apps/mobile/src/session/CompanionNavigationDrawer.tsx b/apps/mobile/src/session/CompanionNavigationDrawer.tsx
index b1c5f9508f..bd6f8911db 100644
--- a/apps/mobile/src/session/CompanionNavigationDrawer.tsx
+++ b/apps/mobile/src/session/CompanionNavigationDrawer.tsx
@@ -29,7 +29,7 @@ export function CompanionNavigationDrawer({ open, onClose, onSearch }: { open: b
return <>
<HomeChromeDrawer open={open} user={auth.user} loggingOut={loggingOut} mode="teammates"
onClose={() => { pending.current = null; onClose(); }} onClosed={finish}
- onModeChange={mode => afterClose(() => { if (mode !== 'teammates') void navigation.chooseMode(mode); })}
+ onModeChange={mode => afterClose(() => { void navigation.chooseMode(mode); })}
onOpenSearch={() => afterClose(onSearch)} onOpenDevices={() => afterClose(() => push('/devices/manage'))}
onOpenSettings={() => afterClose(() => push('/settings'))} onOpenAccounts={() => afterClose(() => setAccounts(true))}
onLogout={() => {
diff --git a/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx b/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
index c32f0bcc11..3fca5833b6 100644
--- a/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
+++ b/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
@@ -1,7 +1,7 @@
-import { iconSize } from '@/theme';
+import { iconSize, spacing } from '@/theme';
import { Fragment, useEffect } from 'react';
import { Button, HStack, Image, Picker, ProgressView, RNHostView, Spacer, Text, TextField, Toggle, useNativeState } from '@expo/ui/swift-ui';
-import { accessibilityLabel, buttonStyle, contentShape, shapes, disabled, font, foregroundStyle, frame, lineLimit, listRowInsets, pickerStyle, tag } from '@expo/ui/swift-ui/modifiers';
+import { accessibilityLabel, alignmentGuide, buttonStyle, contentShape, shapes, disabled, font, foregroundStyle, frame, lineLimit, listRowInsets, pickerStyle, tag } from '@expo/ui/swift-ui/modifiers';
import { useTranslation } from 'react-i18next';
import { resolveRemoteText, type RemoteActionField } from '@cindy/device-link';
import { View } from 'react-native';
@@ -31,6 +31,9 @@ export function CompanionNativeField({ field, values, onChange, busy }: { field:
modifiers={[disabled(busy), accessibilityLabel(label), ...(field.kind === 'multiline' ? [lineLimit({ min: 3, max: 8 })] : [])]} /></Section>;
}
const AVATAR_SIZE = 48;
+// SF Symbols have different intrinsic widths; the title column must not depend on the glyph.
+const ROW_ICON_WIDTH = iconSize.xxl;
+const ROW_GAP = spacing.md;
const Field = CompanionNativeField;
export function CompanionProfileNativeView(p: CompanionProfileNativeViewProps) {
@@ -39,8 +42,8 @@ export function CompanionProfileNativeView(p: CompanionProfileNativeViewProps) {
const label = (value: Parameters<typeof resolveRemoteText>[0]) => resolveRemoteText(value, i18n.language);
const note = (text: string, error = false) => <Section><Text modifiers={[font({ textStyle: 'footnote' }), foregroundStyle(error ? colors.errorText : colors.textSecondary)]}>{text}</Text></Section>;
const action = (text: string, press: () => void, blocked = false, destructive = false) => <Button onPress={press} modifiers={[buttonStyle('plain'), listRowInsets({ top: 4, bottom: 4, leading: 16, trailing: 16 }), disabled(blocked || p.busy), frame({ minHeight: 44 }), ...(destructive ? [foregroundStyle(colors.destructive)] : [])]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{text}</Text><Spacer /></HStack></Button>;
- const row = (id: string, symbol: string, onPress = () => p.onOpen(id)) => <Button onPress={onPress} modifiers={[buttonStyle('plain'), listRowInsets({ top: 4, bottom: 4, leading: 16, trailing: 16 })]} testID={`companionProfile.${id}`}>
- <HStack spacing={12} modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Image systemName={symbol as never} size={iconSize.action} modifiers={[foregroundStyle(colors.textSecondary)]} /><Text>{tr(id)}</Text><Spacer /><Image systemName="chevron.right" size={iconSize.xs} /></HStack>
+ const row = (id: string, symbol: string, onPress = () => p.onOpen(id)) => <Button onPress={onPress} modifiers={[buttonStyle('plain'), listRowInsets({ top: 4, bottom: 4, leading: 16, trailing: 16 }), alignmentGuide('listRowSeparatorLeading', ROW_ICON_WIDTH + ROW_GAP)]} testID={`companionProfile.${id}`}>
+ <HStack spacing={ROW_GAP} modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Image systemName={symbol as never} size={iconSize.action} modifiers={[foregroundStyle(colors.textSecondary), frame({ width: ROW_ICON_WIDTH })]} /><Text>{tr(id)}</Text><Spacer /><Image systemName="chevron.right" size={iconSize.xs} /></HStack>
</Button>;
const panel = (target?: ProfilePanel) => target?.action ? <>
{target.id === 'capability' && target.text ? note(target.text) : null}
diff --git a/apps/mobile/src/session/TeammateHomeScreen.tsx b/apps/mobile/src/session/TeammateHomeScreen.tsx
index af00e715fe..ecb98daa3c 100644
--- a/apps/mobile/src/session/TeammateHomeScreen.tsx
+++ b/apps/mobile/src/session/TeammateHomeScreen.tsx
@@ -20,7 +20,7 @@ import { useTeammateNavigation } from './useTeammateNavigation';
import { findLastTeammate } from './teammateNavigation';
import { remoteSessionStore } from './remoteSessionStore';
-/** Landing/recovery roster; a verified remembered identity reopens its canonical resource once per entry. */
+/** Explicit entry stays on the roster; startup can restore a verified remembered identity. */
export function TeammateHomeScreen({ active = true }: { active?: boolean }) {
const { t } = useTranslation();
const auth = useAuth();
@@ -45,6 +45,7 @@ export function TeammateHomeScreen({ active = true }: { active?: boolean }) {
useCallback(() => accounts && remoteSessionStore.getSessions().some((session) => remoteSessionStore.isSessionRunning(session.id)), [accounts]),
);
useEffect(() => {
+ if (!navigation.restoreLastTeammate) { resumed.current = true; return; }
if (!focused || !navigation.hydrated || roster.loading || resumed.current) return;
// A mounted old screen does not own the user's last explicit mode.
if (navigation.mode !== 'teammates') { resumed.current = true; return; }
diff --git a/apps/mobile/src/session/TeammateList.tsx b/apps/mobile/src/session/TeammateList.tsx
index 3e545ed742..30ecc135b5 100644
--- a/apps/mobile/src/session/TeammateList.tsx
+++ b/apps/mobile/src/session/TeammateList.tsx
@@ -119,9 +119,10 @@ const makeStyles = (colors: ThemeColors) => StyleSheet.create({
body: { flex: 1, minWidth: 0, gap: spacing.xs, borderBottomColor: colors.border,
borderBottomWidth: StyleSheet.hairlineWidth, paddingBottom: spacing.md },
titleRow: { flexDirection: 'row', alignItems: 'center', gap: spacing.sm },
- title: { flex: 1, color: colors.textPrimary, fontSize: typeScale.body, fontWeight: fontWeight.medium },
- preview: { color: colors.textSecondary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption },
- time: { color: colors.textTertiary, fontSize: typeScale.caption },
- meta: { color: colors.textTertiary, fontSize: typeScale.caption },
+ // Match task rows in HomeListVisuals: title, preview and metadata keep the same hierarchy.
+ title: { flex: 1, color: colors.textPrimary, fontSize: typeScale.subtitle, fontWeight: fontWeight.semibold, lineHeight: lineHeight.listTitle },
+ preview: { color: colors.textSecondary, fontSize: typeScale.code, fontWeight: fontWeight.regular, lineHeight: lineHeight.subtitle },
+ time: { color: colors.textTertiary, fontSize: typeScale.footnote, fontWeight: fontWeight.regular, lineHeight: lineHeight.body },
+ meta: { color: colors.textTertiary, fontSize: typeScale.footnote, fontWeight: fontWeight.regular, lineHeight: lineHeight.body },
unread: { width: 7, height: 7, borderRadius: radius.pill, backgroundColor: colors.textPrimary },
});
diff --git a/apps/mobile/src/session/useHomeMode.ts b/apps/mobile/src/session/useHomeMode.ts
index 78a0216272..c49116470b 100644
--- a/apps/mobile/src/session/useHomeMode.ts
+++ b/apps/mobile/src/session/useHomeMode.ts
@@ -14,9 +14,11 @@ interface Snapshot {
hydrated: boolean;
mode: HomeMode;
lastTeammate: LastTeammateIdentity | null;
+ /** Startup recovery only; explicit mode selection must land on the roster. Never persisted. */
+ restoreLastTeammate: boolean;
saveFailed: boolean;
}
-const initial: Snapshot = { hydrated: false, mode: 'tasks', lastTeammate: null, saveFailed: false };
+const initial: Snapshot = { hydrated: false, mode: 'tasks', lastTeammate: null, restoreLastTeammate: true, saveFailed: false };
interface Entry { snapshot: Snapshot; revision: number; loading?: Promise<void> }
const entries = new Map<string, Entry>();
const listeners = new Set<() => void>();
@@ -69,7 +71,12 @@ export function useHomeMode() {
});
});
}, [entry, owner]);
- const setMode = useCallback((mode: HomeMode) => update({ mode }), [update]);
+ const setMode = useCallback((mode: HomeMode) => {
+ // Fence recovery before hydration publishes a remembered teammate or mounts its pane.
+ // Keeping this in the shared in-memory snapshot also covers route remounts.
+ if (owner) publish(entry, { restoreLastTeammate: false });
+ return update({ mode });
+ }, [entry, owner, update]);
const rememberTeammate = useCallback((identity: LastTeammateIdentity | null) => update({ lastTeammate: identity }), [update]);
const selectTeammate = useCallback((identity: LastTeammateIdentity) => update({ mode: 'teammates', lastTeammate: identity }), [update]);
return { ...snapshot, owner, setMode, rememberTeammate, selectTeammate };
diff --git a/docs/design-rules/DESIGN.md b/docs/design-rules/DESIGN.md
index f11be5e477..038b4fadb3 100644
--- a/docs/design-rules/DESIGN.md
+++ b/docs/design-rules/DESIGN.md
@@ -414,6 +414,8 @@ Chat prose and compact code use the existing `chatChrome.ts` presentation entry;
### Mobile iOS navigation chrome / iPhone Duo
+- Explicitly selecting Teammates in the mobile home or chat drawer opens the teammate list, even with one teammate or when Teammates is already active. The mode switch itself never enters a chat; picking a teammate opens it. Keep cold-start recovery of a verified remembered teammate separate from this explicit navigation. Teammate rows share the task list typography: 18pt semibold titles with 28pt line height, 15pt regular previews with 26pt line height, and 13pt metadata with 22pt line height.
+
- Wide Home and task-sidebar presentations share one native list instance in `ResidentHomeListProvider`, outside route lifetimes. Route slots supply layout and callbacks; do not key the host by task/route or restore a cached offset over its live scroll position. Collapse/expand its bounds, keep native headers outside its touch area, and pause hidden row subscriptions. Narrow screens retain their route-local list.
- Home's main menu is a top-left affordance, including when Duo moves native toolbar actions into the right rail. Host this home-only exception in the native header's left custom view with its shared background hidden, never in an absolute screen-content overlay under the transparent navigation bar; remote-desktop and display actions remain native toolbar items.
diff --git a/docs/qa/mobile-teammate-entry-alignment/README.md b/docs/qa/mobile-teammate-entry-alignment/README.md
new file mode 100644
index 0000000000..05c2d1f3d6
--- /dev/null
+++ b/docs/qa/mobile-teammate-entry-alignment/README.md
@@ -0,0 +1,12 @@
+# Mobile teammate entry and settings alignment
+
+- Settings screenshots: iOS 27, 402 × 874 pt simulator, actual `CompanionProfileNativeView.ios.tsx` and native `ComposerSheet`/Form, Chinese, system Light and Dark.
+- All eight icon-bearing rows share the same title and separator start. SF Symbol artwork remains centered in a 26 pt column with the existing 12 pt gap; row touch height remains 44 pt.
+- The screenshots use static, non-sensitive profile props because the simulator's remote hosts were offline. Restart/delete sections are absent from that fixture. No remote action/save acceptance is claimed. The temporary fixture and route replacement were removed before commit.
+- Metro served this branch (`fix-mobile-teammate-list-entry`) on 8081 and hot-reloaded the fixture and changed native component. The standard `mobile:sim:whoami` check does not discover the Baguette device set and reported native-missing; its injected source fingerprint also preceded the temporary fixture. These screenshots are component visual evidence, not full-app identity or end-to-end acceptance.
+- Navigation validation uses the real HomeScreen, HomeModePanes, shared preferences, and navigation hook: single/multiple teammates, late roster arrival, refresh/remount, explicit row selection, and untouched cold startup. The chat drawer separately verifies close-before-return for the already-active teammate mode.
+- Android shares the navigation implementation. Its settings rows already use equally-sized Lucide icons; no Android settings-layout changes. Android device checks and iOS online-host navigation were not performed.
+
+## Teammate typography
+
+The shared TeammateList now uses the existing task-row typography from HomeListVisuals: title 18/28 semibold, preview 15/26 regular, time/status 13/22 regular. These styles apply to the home roster, collection page and embedded name picker on iOS/Android. The Light/Dark list screenshots render the production list with static profiles in an isolated route fixture; long names/previews truncate to one line while timestamps remain readable. They are component evidence, not screenshots of the complete home chrome. No temporary preview code is shipped.
diff --git a/docs/qa/mobile-teammate-entry-alignment/list-dark.jpg b/docs/qa/mobile-teammate-entry-alignment/list-dark.jpg
new file mode 100644
index 0000000000..b96d17831c
Binary files /dev/null and b/docs/qa/mobile-teammate-entry-alignment/list-dark.jpg differ
diff --git a/docs/qa/mobile-teammate-entry-alignment/list-light.jpg b/docs/qa/mobile-teammate-entry-alignment/list-light.jpg
new file mode 100644
index 0000000000..b1a2ff88d2
Binary files /dev/null and b/docs/qa/mobile-teammate-entry-alignment/list-light.jpg differ
diff --git a/docs/qa/mobile-teammate-entry-alignment/profile-dark.jpg b/docs/qa/mobile-teammate-entry-alignment/profile-dark.jpg
new file mode 100644
index 0000000000..19615fdb28
Binary files /dev/null and b/docs/qa/mobile-teammate-entry-alignment/profile-dark.jpg differ
diff --git a/docs/qa/mobile-teammate-entry-alignment/profile-light.jpg b/docs/qa/mobile-teammate-entry-alignment/profile-light.jpg
new file mode 100644
index 0000000000..e6b906eacc
Binary files /dev/null and b/docs/qa/mobile-teammate-entry-alignment/profile-light.jpg differ