PHPackages                             darbaoui/laravel-ui-avatars - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. darbaoui/laravel-ui-avatars

ActiveLibrary[Image & Media](/categories/media)

darbaoui/laravel-ui-avatars
===========================

generate an avatar image based on the name, size and background color and more

1.0.8(3y ago)119.3k↓11.4%MITPHPPHP >=7.2

Since Feb 3Pushed 3y ago1 watchersCompare

[ Source](https://github.com/darbaoui/laravel-ui-avatars)[ Packagist](https://packagist.org/packages/darbaoui/laravel-ui-avatars)[ RSS](/packages/darbaoui-laravel-ui-avatars/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (8)Dependencies (2)Versions (11)Used By (0)

Laravel ui avatar generator based on
=============================================================

[](#laravel-ui-avatar-generator-based-on-httpsui-avatarscom)

[![StyleCI Shield](https://camo.githubusercontent.com/07934d688726db4953f6f4d128150ee4f841d89821e91b59434d4a0323b0aa32/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3333353431333736332f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/335413763)[![build:passed](https://camo.githubusercontent.com/88173641b21be2c7759dcada843070903359dccdbbe6d8de917c09ac74e045da/68747470733a2f2f6170702e7472617669732d63692e636f6d2f64617262616f75692f6c61726176656c2d75692d617661746172732e7376673f6272616e63683d6d6173746572)](https://app.travis-ci.com/darbaoui/laravel-ui-avatars.svg?branch=master)[![Total Downloads](https://camo.githubusercontent.com/504db6d9dea91899193108a7a9b8f909a0a40b744427c4eb6f70e9c5a7d1a13c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64617262616f75692f6c61726176656c2d75692d617661746172732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/darbaoui/laravel-ui-avatars)[![Latest Stable Version](https://camo.githubusercontent.com/71be8970d102c19394cc3490c0879e0542342d8767008dca28d278620b1e2f9e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64617262616f75692f6c61726176656c2d75692d617661746172732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/darbaoui/laravel-ui-avatars)[![License](https://camo.githubusercontent.com/d048f4adf059ffa01e754b7feb82b435df6599ef9db2bb82415861811bc85419/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f64617262616f75692f6c61726176656c2d75692d617661746172732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/darbaoui/laravel-ui-avatars)

Installation
------------

[](#installation)

This package requires Laravel 5.4 or higher.

1. You can install the package via composer:

```
composer require darbaoui/laravel-ui-avatars
```

Usage
-----

[](#usage)

```
use Darbaoui\Avatar\Facades\Avatar;

// simple avatar
Avatar::name('imad darbaoui')
        ->background('ffd1bf')
        ->color('ff4500')->get();
// avatar = https://ui-avatars.com/api/?name=imad+darbaoui&background=ffd1bf&color=ff4500

// you can chain any other method if you want to add other parameters to your avatar
Avatar::name('imad darbaoui')
        ->size(124)
        ->rounded()
        ->uppercase(false)
        ->svg()
        ->background('ffd1bf')
        ->color('ff4500')->get();
// avatar = https://ui-avatars.com/api/?size=124&rounded=1&uppercase=0&format=svg&name=imad+darbaoui&background=ffd1bf&color=ff4500
```

Available methods
-----------------

[](#available-methods)

methodsdescriptiondefault value`name()`The name used to generate initials`John Doe``size()`Avatar image size in pixels. Between: 16 and 512`64``rounded()`Boolean specifying if the returned image should be a circle`false``uppercase()`Decide if the API should uppercase the name/initials.`true``fontSize()`Font size in percentage of size. Between 0.1 and 1.`0.5``background()`Hex color for the image background, without the hash (#)`f0e9e9``color()`Hex color for the font, without the hash (#).`8b5d5d``length()`Length of the generated initials.`2``bold()`Boolean specifying if the returned letters should use a bold font. Default: false`false``svg()`Decide to the avatar should be return SVG`-`

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~79 days

Recently: every ~157 days

Total

9

Last Release

1348d ago

PHP version history (2 changes)1.0.0PHP >=7.2

1.0.1PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0a343c198b191623c228bbae72d3c5722f1dc2ec9b4275beed565ced3f3cf4a?d=identicon)[darbaoui imad](/maintainers/darbaoui%20imad)

---

Top Contributors

[![darbaoui](https://avatars.githubusercontent.com/u/6907747?v=4)](https://github.com/darbaoui "darbaoui (32 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

avatarsgeneratorimagelaravelpictureuiui-avatars

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/darbaoui-laravel-ui-avatars/health.svg)

```
[![Health](https://phpackages.com/badges/darbaoui-laravel-ui-avatars/health.svg)](https://phpackages.com/packages/darbaoui-laravel-ui-avatars)
```

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)