Avatar
Atom
A photo when the account has one, falling back to one or two initials on an identity disc: the name resolves to one of ten hues (or hue picks one), and the disc is that hue's soft wash under initials in the same hue, so one person keeps one colour on every platform and stays distinct in a stack or list. The initials sit at weight 600, 38% of the disc, and their ink is held to 4.5:1 on the wash in both schemes.
Playground
Every control sets a real prop of AvatarProps. The JSX below updates as you go.
Web
iOS
Android
JSX · AvatarProps
Variants
13 examples from src/atoms/avatar/avatar.md, each rendered live from its own JSX.
Sizes
Anatomy
1
Frame
2
Image or initials
3
Ring
Dimmed parts appear only in some states or variants.
Props
36 props on AvatarProps, grouped as they are declared in source. Required props are marked *.
Accessibility and keyboard
Keyboard
Not focusable. It has no interaction of its own and takes the semantics of what it wraps.
Semantics
Roles
button
ARIA on web
aria-hidden
aria-label
Platform skins
The playground's props on each platform: same tree, native shapes, type and touch sizes.
Usage
Like a photo, the disc is identity content: it keeps its colours under glass, where only the neutral tile of an avatar with no name or initials takes the control material. AvatarMenu builds the signed-in account control on the same circle: one capsule trigger carrying the avatar, the name, and the email, opening the account menu under that same identity.
Argus identity sizes are available as annotation (16), compact (30), account (32), row (36), person (38), profile (44), detail (52), hero (58), featured (60), and spotlight (74), in that precedence order. These retain their reference initials metrics, including the existing 9px annotation glyph.
hue selects a stage identity independently of its name. whiteInk preserves white reference initials; bold uses the 700 weight. sheen, mediumSheen, and strongSheen add the 2, 2.5 and 3px conic ring (strongest wins). inverse is the translucent white identity disc, orchid the account gradient, and glow its selected account ring. These reference discs keep the identity gradient. On the four stock sizes, glow is a 2px gap in the page colour inside the accent's soft glow, and ring stays the separator ring a stack draws between discs.
Tokens
Read from the playground render. Values follow the scheme and the ion hue.
--fd
--ft