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
sourceImageSourceImage source. Falls back to initials when not provided
namestringFull name used to generate initials when no image source is provided
sizenumbertheme mediumDiameter of the avatar in pixels
isLoadingbooleanfalseShow a circular loading skeleton in place of the avatar

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