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 1mo 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

29

—

LowBetter than 59% of packages

Maintenance35

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

604d 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.4M31](/packages/laravolt-avatar)[anlutro/l4-settings

Persistent settings in Laravel.

9312.4M19](/packages/anlutro-l4-settings)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[beyondcode/laravel-favicon

Create dynamic favicons based on your environment settings.

37345.5k](/packages/beyondcode-laravel-favicon)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)

PHPackages © 2026

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