@vuecs/gravatar

A package containing a gravatar component.
5,730 4
Install
npm install @vuecs/gravatar
Latest Version:2.1.1
Vue:3
License:Apache-2.0
Last Updated:Oct 16, 2026
Links: GitHub  ·  npm
Maintainer: tada5hi

@vuecs/gravatar

npm version CI license

<VCGravatar> — Gravatar avatars for Vue 3, part of vuecs. Hashes the email client-side, builds the Gravatar URL, and renders through <VCAvatar> so you get graceful fallback content for free.

✨ What's inside

  • 📧 email or precomputed hash — pass either; hashing happens for you.
  • 🖼️ Fallback support — composes <VCAvatar> from @vuecs/elements: broken/missing images fall back to your #fallback slot (initials, icon, …).
  • ⚙️ Full Gravatar API surface — size, defaultImg (retro by default), rating, custom hostname / protocol for self-hosted proxies.
  • 📐 Display sizing — displaySize (sm / md / lg) maps onto the avatar's theme variant, independent of the fetched pixel size.

📦 Installation

npm install @vuecs/gravatar

⚡ Usage

<VCGravatar email="user@example.com" :size="160" display-size="lg">
    <template #fallback>JD</template>
</VCGravatar>

📚 Documentation

Full reference + live demo: vuecs.dev/components/gravatar

License

Made with 💚

Published under Apache 2.0 License.

Related Packages

@sauromates/vue-gravatar

Reusable, customizable and fully typed Gravatar component for Vue3 projects.

5,372 2
vue-boring-avatars

vue-boring-avatars is a Vue.js port of Boring Avatars, a JS library that generat...

2,151,679 126
vue3-gravatar

Vue 3 Gravatar

15,989 4
vue-avatar

Avatar component for Vue.js

466,478 612
vue-avatar-3

A useful avatar component for Vue 3, with support for letter avatars.

7,661 1

Version History

Version Released Vue License
2.1.1 ^3.x Apache-2.0
2.1.0 ^3.x Apache-2.0
2.0.10 ^3.x Apache-2.0
2.0.9 ^3.x Apache-2.0
2.0.8 ^3.x Apache-2.0