Static UIStatic UI Docs
HomeComponentsBlocksTemplatesThemesShowcaseStorybookGitHub

Getting Started

  • Introduction
  • Installation
  • Theming
  • CLI

Components

AccordionAlertAlert DialogAspect RatioAvatarBadgeBreadcrumbButtonCalendarCardCarouselCheckboxCollapsibleContext MenuDialogDrawerDropdown MenuHover CardInputInput GroupInput OTPKbdLabelNumber FieldPaginationPopoverProgressRadio GroupScroll AreaSelectSeparatorSidebarSkeletonSliderSonnerSpinnerSwitchTableTabsTextareaToastToggleToggle GroupTooltipTypography

Blocks

  • Overview
  • Dashboard 01
  • Dashboard 02
  • Login 01
  • Login 02
  • Pricing 01
  • Pricing 02
  • Hero 01
  • Hero 02
  • Feature 01
  • Feature 02

Templates

  • Overview
  • Marketing
  • Dashboard
  • Auth

Themes

  • Overview
  • Green
  • Blue
  • Zinc
  • Slate
  • Gaming
  • Cyberpunk
  • Modern

Showcase

  • Showcase

Developers

  • Architecture
  • Monorepo Structure
  • Development Workflow
  • Contributing
  • Testing
  • Release Process
  • Commit Conventions
  • Versioning
  • CI/CD
  • Project Health

Getting Started

  • Introduction
  • Installation
  • Theming
  • CLI

Components

AccordionAlertAlert DialogAspect RatioAvatarBadgeBreadcrumbButtonCalendarCardCarouselCheckboxCollapsibleContext MenuDialogDrawerDropdown MenuHover CardInputInput GroupInput OTPKbdLabelNumber FieldPaginationPopoverProgressRadio GroupScroll AreaSelectSeparatorSidebarSkeletonSliderSonnerSpinnerSwitchTableTabsTextareaToastToggleToggle GroupTooltipTypography

Blocks

  • Overview
  • Dashboard 01
  • Dashboard 02
  • Login 01
  • Login 02
  • Pricing 01
  • Pricing 02
  • Hero 01
  • Hero 02
  • Feature 01
  • Feature 02

Templates

  • Overview
  • Marketing
  • Dashboard
  • Auth

Themes

  • Overview
  • Green
  • Blue
  • Zinc
  • Slate
  • Gaming
  • Cyberpunk
  • Modern

Showcase

  • Showcase

Developers

  • Architecture
  • Monorepo Structure
  • Development Workflow
  • Contributing
  • Testing
  • Release Process
  • Commit Conventions
  • Versioning
  • CI/CD
  • Project Health

Navigation

Aspect RatioBadge

Component Info

CategoryData Display
StatusStable
FrameworkReact

Package

@static-ui/ui

Contribute

  • Report an issue
  • GitHubRequest a feature
  • Edit this page

Resources

  • Storybook
  • GitHub
  • Documentation
  1. Docs
  2. Components
  3. Avatar

Avatar

Data Display

An image element with a fallback placeholder that represents a user or entity.

Loading component...

Installation

Run the following command to add this component to your project:

$pnpm dlx static-ui add avatar

Import

Import the component directly from the package:

import { Avatar } from "@static-ui/ui"

API Reference

Common props available for this component:

PropTypeDescription
srcstringThe image source URL.
altstringAlternative text for the image.
fallbackReact.ReactNodeFallback content when image is loading or fails.
classNamestringAdditional CSS classes to apply.

Dependencies

  • @base-ui/react

Accessibility

Requires `alt` text on `AvatarImage` for screen reader users. The `AvatarFallback` provides accessible text when the image fails to load.

Related Components

BadgeStatus labels and counters.
KbdKeyboard key indicator.
TableStructured data grid.