Messages

Conversation list for a direct-messages inbox.

Preview

Open the exact pattern in the real BeeUI Web Showcase. This is a Web runtime preview, not native-device evidence.

Each named state is directly addressable:

The same source is available at apps/showcase/patterns/commerce-social/screens/messages-screen.tsx.

Composition

Principal public BeeUI exports used by this screen: EmptyState, SearchInput, Text, VStack.

The pattern is a composition recipe rather than a new framework layer. Follow the linked component contracts for state, provider, platform and accessibility details.

State and callback contract

The screen is controlled through MessagesScreenProps. User intent crosses the application boundary through onConversationSelect; fetching, routing, persistence and side effects remain application-owned.

// from apps/showcase/patterns/commerce-social/fixtures/social-fixtures.ts
export type Conversation = {
  id: string;
  user: SocialUser;
  lastMessage: string;
  timestamp: string;
  unreadCount: number;
};

// from apps/showcase/patterns/commerce-social/fixtures/social-fixtures.ts
export type SocialUser = {
  id: string;
  name: string;
  handle: string;
  avatarUri: string;
  fallback: string;
  bio: string;
};

export type MessagesScreenProps = {
  empty?: boolean;
  onConversationSelect?: (conversation: Conversation) => void;
};

Common product states such as loading, success, empty, error, permission-like recovery, filtering/search/selection or pagination are represented only where the actual screen source exposes them. The pattern docs do not invent backend states that the fixture does not render.

Responsive contract

Read from the screen file and the 3 pattern-local files in its runtime import closure, direct and transitive: commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/fixtures/social-fixtures.ts. Every fact below is scoped to those files and to nothing else.

BeeUI layout primitives rendered: Box (commerce-social/components/screen-shell.tsx), HStack (commerce-social/components/message-row.tsx), Screen (commerce-social/components/screen-shell.tsx), VStack (commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/screens/messages-screen.tsx).
Scroll ownership: ScrollView (commerce-social/components/screen-shell.tsx).
Horizontal scrolling: no horizontal scroll container in commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/fixtures/social-fixtures.ts.
Width constraint: max-w-2xl (commerce-social/components/screen-shell.tsx), max-w-3xl (commerce-social/components/screen-shell.tsx).
Breakpoint-prefixed utility classes: none in commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/fixtures/social-fixtures.ts.
Platform-prefixed utility classes: web:px-6 (commerce-social/components/screen-shell.tsx).
Platform branching: no Platform.OS or Platform.select call in commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/fixtures/social-fixtures.ts.
Viewport measurement: no useWindowDimensions, Dimensions.get or breakpoint hook in commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx, commerce-social/components/screen-shell.tsx, commerce-social/fixtures/social-fixtures.ts.

BeeUI’s mobile-first responsive contract is the framework-level document; the list above states only what this screen’s own files declare, and says nothing about how the composed components behave internally.

Accessibility

Roles this screen sets itself: button (commerce-social/components/message-row.tsx).
Accessibility states and properties it sets itself: accessibilityLabel (commerce-social/screens/messages-screen.tsx, commerce-social/components/message-row.tsx).
Semantics inherited from composed BeeUI families: Avatar, Badge, Box, Card, EmptyState, HStack, Screen, SearchInput, Text, VStack — each family’s own page derives the roles and states it sets; they are not restated here.

Touch-target size, focus order, announcements, RTL, large-text and reduced-motion behavior are not derived from this source — see the Accessibility guide for what is and is not covered by evidence. A Web preview does not substitute for VoiceOver/TalkBack runtime evidence.

Application ownership boundary

Intentionally excluded: Message fetching, realtime updates, and thread navigation.

BeeUI does not take ownership of app routing, authentication/business rules, APIs/data fetching, persistence, form/state frameworks, chart frameworks or backend logic merely because a pattern visually composes those product concepts.

Source ownership

MessagesScreen is Showcase source you copy, not a package export: it is not shipped from any @beemvp/beeui-* package, and the Registry CLI (pnpm beeui list / pnpm beeui add) does not carry pattern screens. Copy apps/showcase/patterns/commerce-social/screens/messages-screen.tsx into your app and adapt it directly. Only the individual BeeUI components it composes (linked above) are available for source ownership through the repository-local Registry workflow; see CLI & source ownership for both the published npx @beemvp/beeui-cli@next path and the repository-local checkout path.