The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
clerk-docs	Ready	Preview	Oct 28, 2025 6:43pm

@tmilewski have submitted a docs review with a few changes. Feel free to check out the commit and let me know if you have any thoughts.

I will test this with the diff SDKs, and if that's all good, then it should be good to go.

Tagging @alexisintech for visibility on this.

@SarahSoutoul Thank you!!

@tmilewski One comment I had was regarding the picture - it appeared really small, so I removed the styling in my docs review, and it looks a bit better. But I feel like the avatar is still really small - wondering if we could get a better image with the actual avatar being bigger?

Before:

After:

Update on this one @alexisintech:

• Have tested the code examples for all SDKs, and noticed issues with Astro, Expo and Nuxt. @tmilewski is currently fixing those.
• For the image, @tmilewski is going to create a ticket for the Design team to have some better images for the component.

Update on this one @alexisintech:

• Have tested the code examples for all SDKs, and noticed issues with Astro, Expo and Nuxt. @tmilewski is currently fixing those.
• For the image, @tmilewski is going to create a ticket for the Design team to have some better images for the component.

Another update @alexisintech:

• Issues with Astro, Expo and Nuxt are now fixed, so all code examples work as expected.
• Ticket for the image for the Design team is here: https://linear.app/clerk/issue/DSN-705/imagery-docs-useravatar.

That's the remaining element before approving this, so feel free to review my docs review and any other things while we wait for the image.

@tmilewski @SarahSoutoul it looks like there's some extra props here that weren't documented: component and fallback

is there more info surrounding these?

@alexisintech Where are you seeing that?

@tmilewski @SarahSoutoul it looks like there's some extra props here that weren't documented: component and fallback

is there more info surrounding these?

From the JS repo, there are only two props available:

Actually, there is a merge of props @tmilewski

So on top of the UserAvatarProps, there is fallback and component

Actually, there is a merge of props @tmilewski

So on top of the UserAvatarProps, there is `fallback` and `component`

yup! let's get those documented please :)

Add missing prop

@tmilewski @alexisintech have added the fallback prop here, and updated all the props as optional after looking at the JS repo. But, I am confused about component, and what it does to be honest - in the snippet below, it is part of WithClerkProp, which is something used in other components, yet, not documented on these components. Let me know thoughts!

we don't really put "optional" for any prop descriptions, because the ? marker is there. i wouldn't start doing that now, as to keep all of the docs consistent

we don't really put "optional" for any prop descriptions, because the ? marker is there. i wouldn't start doing that now, as to keep all of the docs consistent

Have reverted back the old description for rounded here. However, kept the descriptions for fallback and appearance, since those are used across the docs.

we don't really put "optional" for any prop descriptions, because the ? marker is there. i wouldn't start doing that now, as to keep all of the docs consistent

Have reverted back the old description for rounded here. However, kept the descriptions for fallback and appearance, since those are used across the docs.

hmm maybe we should do a props table clean up and get those consistent across the docs - just a chore though, not a high priority. i can create a ticket !