PHPackages                             mmnijas/avatar - 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. [Utility & Helpers](/categories/utility)
4. /
5. mmnijas/avatar

ActiveLibrary[Utility & Helpers](/categories/utility)

mmnijas/avatar
==============

Avatar Generator is a lightweight PHP package designed to generate avatars based on user names. It offers two flexible modes for avatar generation, letter based avatar and random image avatar

1.0.2(1y ago)134MITPHPPHP >=8.1

Since Sep 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mmnijas/avatar)[ Packagist](https://packagist.org/packages/mmnijas/avatar)[ RSS](/packages/mmnijas-avatar/feed)WikiDiscussions main Synced 3d ago

READMEChangelogDependencies (4)Versions (10)Used By (0)

Here’s a complete `README.md` file with all the content grouped together:

```
# Avatar Generator

A simple and customizable avatar generator for PHP that creates PNG images based on user initials. This package uses the Intervention Image library for image manipulation.

## Features

- Generates avatar images with user initials.
- Customizable image size, background color, and text color.
- Uses random dark shades for backgrounds.
- Supports single and double initials.

## Installation

To install the Avatar Generator package, you can include it in your `composer.json` or run the following command:

```bash
composer require mmnijas/avatar
```
```

### Requirements

[](#requirements)

- PHP 7.2 or higher
- Intervention Image library

You can install the Intervention Image library via Composer:

```
composer require intervention/image
```

Usage
-----

[](#usage)

### Route Definition

[](#route-definition)

First, you need to define a route for generating avatars in your `web.php` file:

```
Route::get('/avatar', [AvatarController::class, 'generateAvatar'])->name('avatar');
```

### Controller Function

[](#controller-function)

In your controller (e.g., `AvatarController`), add the following function:

```
use Mmnijas\Avatar\Generate;
use Illuminate\Http\Request;

public function generateAvatar(Request $request)
{
    return Generate::avatar($request->all());
}
```

### Displaying the Avatar

[](#displaying-the-avatar)

You can generate and display an avatar image in your Blade view using the following code:

```

```

### Customization Options

[](#customization-options)

You can customize the avatar by passing additional parameters:

- **name**: The full name from which initials will be extracted (default is "John Doe").
- **size**: The size of the avatar image in pixels (default is 200).
- **bg**: Background color in hexadecimal format (optional).
- **color**: Text color in hexadecimal format (optional).

#### Example with Customization

[](#example-with-customization)

```

```

Example Code
------------

[](#example-code)

Here’s a complete example of how to set everything up:

1. **Define Route** in `web.php`:

    ```
    Route::get('/avatar', [AvatarController::class, 'generateAvatar'])->name('avatar');
    ```
2. **Controller Function** in `AvatarController`:

    ```
    use Mmnijas\Avatar\Generate;
    use Illuminate\Http\Request;

    public function generateAvatar(Request $request)
    {
        return Generate::avatar($request->all());
    }
    ```
3. **Display Avatar** in your Blade view:

    ```

    ```

    ```

    ```

License
-------

[](#license)

This package is open-source software licensed under the MIT License.

Contributing
------------

[](#contributing)

If you would like to contribute to this package, feel free to submit a pull request or open an issue.

Acknowledgments
---------------

[](#acknowledgments)

Thanks to the [Intervention Image](http://image.intervention.io/) library for providing the tools to manipulate images easily.

```

```

```
composer require mmnijas/avatar

```

use App\\Http\\Controllers\\TestController;

Route::get('/avatar', \[TestController::class, 'generateAvatar'\])->name('avatar');

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

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

Every ~0 days

Total

9

Last Release

652d ago

Major Versions

0.0.6 → 1.0.02024-09-21

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8189422?v=4)[Nijas M M](/maintainers/mmnijas)[@mmnijas](https://github.com/mmnijas)

---

Top Contributors

[![mmnijas](https://avatars.githubusercontent.com/u/8189422?v=4)](https://github.com/mmnijas "mmnijas (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[laravolt/avatar

Turn name, email, and any other string into initial-based avatar or gravatar.

2.0k5.8M39](/packages/laravolt-avatar)[toin0u/geocoder-laravel

Geocoder Service Provider for Laravel

7615.4M17](/packages/toin0u-geocoder-laravel)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[propaganistas/laravel-disposable-email

Disposable email validator

6023.0M7](/packages/propaganistas-laravel-disposable-email)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k91.9k1](/packages/mike-bronner-laravel-model-caching)[harris21/laravel-fuse

Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures.

44855.7k](/packages/harris21-laravel-fuse)

PHPackages © 2026

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