039 Chat
Mixed finishes

Chat List

Chat Pro

Scan an inbox where unread chats stand out and read chats settle back. New messages lift their row to the top, with pinned faces, filters, swipe actions and read receipts close at hand.

More in Chat

View all 12

Agent prompt

Paste into Claude Code, Cursor or Devin to rebuild this screen.
Recreate the "Chat List" screen in React Native using LumioUI.

Goal: Scan an inbox where unread chats stand out and read chats settle back. New messages lift their row to the top, with pinned faces, filters, swipe actions and read receipts close at hand. Match the reference implementation's layout, behavior, and motion exactly — this is a production screen, not a mockup.

## Setup

Fastest path — install the screen plus its component deps:

```bash
npx @lumioui/cli add pro/chat-chat-list
```

Or pull just the components: `npx @lumioui/cli add avatar button empty-state icon pro/swipeable-row text typing-indicator`

Native packages:
- react-native-reanimated@*
- react-native-safe-area-context@*
- react-native-svg@*

Stack assumptions: Expo SDK 54 / RN 0.81, Reanimated 4, NativeWind v4, TypeScript strict, Expo Go compatible.

## Components — how, where, when

### `avatar` — Circular profile image with fallback initials and a presence dot. An optional mode shows presence on the photo itself, bright when online and faded when away or offline.
- `<Avatar>` ×1

### `button` — Pill button that presses down under your finger, in eight styles from solid to glass, with a built-in loading state that swaps in place while an action runs.
- `<Button>` ×1

### `empty-state` — Placeholder for empty lists, no search results and errors, with an icon, headline, short message and action. Soft light falls from the top as the content fades in.
- `<EmptyState>` ×1

### `icon` — Icon set drawn on one consistent grid, sized and coloured from your theme. The heart, star and bookmark can fill in place inside their outline, then fade back out.
- `<Icon>` ×13

### `swipeable-row` — List row that swipes to reveal actions on either side. Pull far enough and the main action fills the row and runs when you let go; deleted rows fold away and only one row stays open.
- `<SwipeableRow>` ×1

### `text` — Themed type scale from caption to display that follows light and dark mode. Includes a pull-quote style with an accent rule and a quieter dimmed tone for secondary text.
- `<Text>` ×17

### `typing-indicator` — Chat typing indicator with three dots that brighten in turn. When the reply arrives, the bubble grows to fit it and the words appear in reading order.
- `<TypingIndicator>` ×1

## Conventions (non-negotiable)

- Styling via NativeWind `className` with semantic tokens only: `bg-background`, `text-foreground`, `bg-card`, `text-card-foreground`, `bg-secondary`, `bg-muted`, `text-muted-foreground`, `bg-accent`, `bg-destructive`, `border-border`. Hard-coded colors only inside media overlays (`text-white`, `bg-black/N`).
- Motion via the token presets from `@lumioui/core` (`spring.press`, `spring.surface`, `spring.glide`, `timing.fast`, `timing.slow`, …) — no bespoke spring configs or durations.
- Gate transform motion behind `useReducedMotion()`; keep opacity/color feedback, drop travel and overshoot.
- Haptics via `useHaptic()`: `light` on press, `selection` on toggle/select, `warning` on invalid input. Never import expo-haptics directly.
- Press feedback via `usePressAnimation()` (~0.97 scale), not `activeOpacity` tricks.
- a11y: `accessibilityRole` + `accessibilityLabel` on every control, touch targets ≥44pt.
- Entrance choreography: staggered `Mount` wrappers (delay 0/60/120…) so regions land in sequence instead of popping in at once.
- Wrap the screen in `SafeAreaView`; keep dark mode working via the semantic tokens.

## Deliverable

One file: `screens/chat/chat-list.tsx` exporting ChatListScreen. Preserve the props interface — the host app wires the callbacks (navigation, submit handlers) through them.

## Reference implementation

This is a LumioUI Pro item: its source is not published in the docs. Install it with a Pro license key
(set `LUMIO_LICENSE_KEY`; keys are on lumioui.com/account) and read the installed file as the reference:

```bash
npx @lumioui/cli add pro/chat-chat-list
```

The source lands at `screens/chat/chat-list.tsx`.

Screen: https://lumioui.com/screens/chat-chat-list