SurfacesNew
Glass Avatar
A round photo that falls back to initials, with a presence dot and stacked groups.
Preview
Demos ready. Update 0.
The preview runs the React version. On iOS 26 and later, the React Native version uses the system’s own glass. See it on a phone.
Installation
For React 19+ apps with Tailwind CSS 4.
npx shadcn@4.14.1 add @glassyui/glass-avatarAdds 5 files to components/glassyui and installs @radix-ui/react-avatar and clsx.
Usage
Usage
import { GlassAvatar } from "@/components/glassyui/glass-avatar";
export function PersonDemo() {
return <GlassAvatar name="Ada Lovelace" src="/ada.jpg" status="online" />;
}React Native usage
import { View } from 'react-native';
import { GlassAvatar, GlassAvatarGroup } from '@/components/glassyui/glass-avatar';
const TEAM = ['Ada Lovelace', 'Grace Hopper', 'Alan Turing', 'Katherine Johnson'];
export default function AvatarExample() {
return (
<View style={{ alignItems: 'center', flexDirection: 'row', gap: 16 }}>
{/* Pass src or source for a photo; the initials show until it loads. */}
<GlassAvatar name="Morgan Lee" size="lg" status="online" />
<GlassAvatarGroup accessibilityLabel="Team" max={3}>
{TEAM.map((name) => (
<GlassAvatar key={name} name={name} />
))}
</GlassAvatarGroup>
</View>
);
}
Examples
A stacked group
<GlassAvatarGroup max={4} aria-label="Team">
{people.map((person) => (
<GlassAvatar key={person} name={person} />
))}
</GlassAvatarGroup>API reference
GlassAvatar
A span with role img, named by alt or name plus its status; the photo uses Radix Avatar inside it.
| Prop | Type | Default | Description |
|---|---|---|---|
name | string | None | The person's name; supplies the initials and a stable initials colour. |
src | string | None | Image URL; the initials show until it loads, or if it fails. |
alt | string | name | Accessible name of the avatar. |
fallback | ReactNode | initials of name | Replaces the initials. |
size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'md' | Diameter; ignored inside a GlassAvatarGroup, which sizes its avatars. |
status | 'online' | 'away' | 'busy' | 'offline' | None | A presence dot on the corner, also added to the accessible name. |
Also accepts HTML span attributes, except children.
GlassAvatarGroup
A div with role group that overlaps its avatars.
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | None | GlassAvatar elements, placed directly inside the group. |
max | number | None | Shows this many avatars, then a +N avatar for the rest. |
size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'md' | Sizes every avatar in the group, overriding each avatar's own size. |
Also accepts HTML div attributes.
- Types
GlassAvatarPropsGlassAvatarSizeGlassAvatarStatusGlassAvatarGroupProps- Accessibility
- Name each GlassAvatarGroup with aria-label; the avatar announces its name and status.
The React Native props and exports are in the component’s source.