PHPackages                             murtaza1904/avatar-generator - 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. murtaza1904/avatar-generator

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

murtaza1904/avatar-generator
============================

A simple Laravel package to generate avatar images from user name initials (PNG & SVG).

1.0.0(7mo ago)1111MITPHPPHP ^8.1

Since Sep 23Pushed 3mo agoCompare

[ Source](https://github.com/Murtaza1904/avatar-generator)[ Packagist](https://packagist.org/packages/murtaza1904/avatar-generator)[ Docs](https://github.com/murtaza1904/avatar-generator)[ RSS](/packages/murtaza1904-avatar-generator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (2)Used By (0)

---

Laravel Avatar Generator
========================

[](#laravel-avatar-generator)

A simple and customizable avatar generator for Laravel applications. Generate **PNG** or **SVG** avatars with initials, dynamic colors, and flexible configuration.

---

📦 Installation
--------------

[](#-installation)

```
composer require murtaza1904/avatar-generator
```

---

⚙️ Configuration
----------------

[](#️-configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=avatar-config
```

This will create `config/avatar.php`:

```
return [
    'width' => 128,
    'color' => '#ffffff',
    'format' => 'png',
    'storage' => storage_path('app/public/avatars'),
    'filename_pattern' => '{name}-{timestamp}.{ext}',
    'palette' => [
        '#1abc9c','#2ecc71','#3498db','#9b59b6','#34495e',
        '#16a085','#27ae60','#2980b9','#8e44ad','#2c3e50',
        '#f39c12','#d35400','#c0392b','#7f8c8d','#e67e22',
    ],
];
```

---

🚀 Usage
-------

[](#-usage)

### Generate & Save Avatar

[](#generate--save-avatar)

```
use murtaza1904\AvatarGenerator\Facades\Avatar;

// Save avatar to default storage (config/avatar.php → storage)
$filename = Avatar::create('John Doe')
    ->size(128)
    ->background('#3498db')
    ->color('#ffffff')
    ->format('png')
    ->save();

echo $filename; // john-doe-1695382930.png
```

### Save Avatar to Custom Directory

[](#save-avatar-to-custom-directory)

```
$filename = Avatar::create('Jane Smith')
    ->filename('custom-avatar.png')
    ->path(storage_path('app/public/avatars'));
```

### Get Raw SVG/PNG

[](#get-raw-svgpng)

```
$svg = Avatar::create('Ali Khan')
    ->format('svg')
    ->render();

echo $svg; // outputs SVG XML string
```

---

🎨 Features
----------

[](#-features)

- Generate avatars from initials (supports multi-word names).
- PNG and SVG output.
- Customizable size, colors, format, and filename.
- Configurable color palette.
- Laravel Facade with IDE autocompletion.
- Zero dependencies beyond Laravel & GD extension.

---

🛠️ Requirements
---------------

[](#️-requirements)

- PHP 8.1+
- Laravel 10+
- GD extension (for PNG support)

---

📄 License
---------

[](#-license)

MIT © [Murtaza1904](https://github.com/murtaza1904)

---

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance73

Regular maintenance activity

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

232d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/15a7a6c104d7f985a4ff9742315e01f2684472215f76730a9b618dab4fad1613?d=identicon)[murtaza1904](/maintainers/murtaza1904)

---

Top Contributors

[![Murtaza1904](https://avatars.githubusercontent.com/u/71174090?v=4)](https://github.com/Murtaza1904 "Murtaza1904 (3 commits)")

---

Tags

laravelgeneratorsvgpngavatarInitialsprofile picture

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/murtaza1904-avatar-generator/health.svg)

```
[![Health](https://phpackages.com/badges/murtaza1904-avatar-generator/health.svg)](https://phpackages.com/packages/murtaza1904-avatar-generator)
```

###  Alternatives

[creativeorange/gravatar

A Laravel Gravatar package for retrieving gravatar image URLs or checking the existance of an image.

5467.5M54](/packages/creativeorange-gravatar)[lasserafn/php-initial-avatar-generator

A package to generate avatars with initials for PHP

4374.2M13](/packages/lasserafn-php-initial-avatar-generator)[yzalis/identicon

Generate unique identicon avatars from any string

5901.1M21](/packages/yzalis-identicon)[jkphl/iconizr

A PHP command line tool for converting SVG images to a set of CSS icons (SVG & PNG, single icons and / or CSS sprites) with support for image optimization and Sass output

4869.0k](/packages/jkphl-iconizr)[irazasyed/laravel-identicon

Laravel Identicon Package

2329.5k1](/packages/irazasyed-laravel-identicon)[choowx/rasterize-svg

A PHP library for converting SVG to JPEG, PNG, and WEBP

2261.7k](/packages/choowx-rasterize-svg)

PHPackages © 2026

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