Skip to main content

MultinaireAvatar

A circular avatar component for displaying user profile images with initials fallback support.

Basic Usage

import { MultinaireAvatar } from '@multinaire/multinaire-design';

// With image source
<MultinaireAvatar source={{ uri: 'https://example.com/avatar.jpg' }} />

// With name fallback (shows initials when no image)
<MultinaireAvatar name="John Doe" />

// With both (shows initials while loading or if image fails)
<MultinaireAvatar
source={{ uri: 'https://example.com/avatar.jpg' }}
name="John Doe"
/>

Props

PropTypeDefaultDescription
sourceImageSource-Image source (same as expo-image)
namestring-User's name for generating initials fallback
sizenumbervariables.height.mediumAvatar size in pixels
isLoadingbooleanfalseShow loading skeleton

Examples

Different Sizes

<MultinaireAvatar name="John Doe" size={32} />
<MultinaireAvatar name="John Doe" size={48} />
<MultinaireAvatar name="John Doe" size={64} />

Loading State

<MultinaireAvatar isLoading size={48} />

With Remote Image

<MultinaireAvatar
source={{ uri: user.avatarUrl }}
name={user.displayName}
size={56}
/>

Features

  • Circular shape: Automatically renders as a circle
  • Initials fallback: Shows user initials when no image is provided or while loading
  • Theme-aware sizing: Uses theme variables for consistent sizing
  • Loading state: Built-in skeleton loading support