PHPackages                             xuma/laravel-amaran - 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. [Mail & Notifications](/categories/mail)
4. /
5. xuma/laravel-amaran

ActiveLibrary[Mail & Notifications](/categories/mail)

xuma/laravel-amaran
===================

Laravel 5 Notification

1.1.0(8y ago)238037[2 issues](https://github.com/hakanersu/amaran-laravel/issues)MITPHPPHP >=5.4.0

Since Jan 16Pushed 8y ago4 watchersCompare

[ Source](https://github.com/hakanersu/amaran-laravel)[ Packagist](https://packagist.org/packages/xuma/laravel-amaran)[ RSS](/packages/xuma-laravel-amaran/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

AmaranJS Laravel 5 Package
==========================

[](#amaranjs-laravel-5-package)

[![Laravel](https://camo.githubusercontent.com/fefa73cbcb138f313755edeb816d67030c8ca82a24371d2c30c4605f1a1d6b86/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d352e302d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](http://laravel.com)[![Source](https://camo.githubusercontent.com/7e2b2ee09865500a7146f1fa758d47732a3fc3321ebee8e5f26f2eecce076524/687474703a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d68616b616e657273752f616d6172616e6c61726176656c2d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/hakanersu/amaran-laravel)[![License](https://camo.githubusercontent.com/30597ff9a350144f03bffdd9183e16468e0b3ca1193e1d08591d992622738d55/687474703a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://tldrlegal.com/license/mit-license)

[AmaranJS](https://github.com/hakanersu/AmaranJS) L5 package is a Laravel wrapper for my jquery plugin [AmaranJS](https://github.com/hakanersu/AmaranJS).You can create easy and stylish notifications with [AmaranJS](https://github.com/hakanersu/AmaranJS).

Package Demo:

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

[](#installation)

Begin by installing the package through Composer. You can add your composer.json require section:

```
"xuma/laravel-amaran": "1.1.0"
```

Don't forget to update `composer update`.

Once this operation is complete, simply add both the service provider and facade classes to your project's `config/app.php` file:

#### Service Provider

[](#service-provider)

```
Xuma\Amaran\AmaranServiceProvider::class,
```

#### Facade

[](#facade)

```
'Amaran' => Xuma\Amaran\Facades\Amaran::class,
```

#### Installing AmaranJS jQuery Plugin

[](#installing-amaranjs-jquery-plugin)

You can choose to install AmaranJS manually or you can publish assets.

If you choose install manually, extract your [AmaranJS](https://github.com/hakanersu/AmaranJS) files to public/ directory. You can find installation documentation of [AmaranJS](https://github.com/hakanersu/AmaranJS) [here](https://github.com/hakanersu/AmaranJS).

You can publish assets with below command and assets will be placed in /css, /js folders.

```
php artisan vendor:publish --provider="Xuma\Amaran\AmaranServiceProvider" --tag="assets"
```

#### Default configuration.

[](#default-configuration)

If you want to use same configuration by default you can use configuration file. You can publish configuration file with below command.

```
php artisan vendor:publish --provider="Xuma\Amaran\AmaranServiceProvider" --tag="config"
```

#### Adding Output View

[](#adding-output-view)

Add required view after your jQuery and AmaranJS links.

```
@include('amaran::javascript')
```

Example:

```

@include('amaran::javascript')
```

Usage
-----

[](#usage)

Usage is very simple.If you want to use default theme;

```
Amaran::content(['message'=>'Hello World!'])->create();
```

#### Using AmaranJS Functions

[](#using-amaranjs-functions)

You can use most [AmaranJS](https://github.com/hakanersu/AmaranJS) functions as methods like :

```
Amaran::content([ 'message'=>'Hello World!'])
    ->position('top right')
    ->inEffect('slideRight')
    ->outEffect('slideBottom')
    ->sticky(true)
    ->create();
```

#### Binding Javascript Events to Element

[](#binding-javascript-events-to-element)

You can define javascript events with `bind()` method

```
Amaran::content(['message'=>'Hello World!'])
    ->position('top right')
    ->bind('#start','click')
  - >create();
```

#### Using as Flash Message

[](#using-as-flash-message)

Normally AmaranJS bind to current view but you can add `->flash()` method for bind to redirected methods view.

```
Amaran::content(['message'=>'Hello World'])->flash()->create();
```

Theme Usage
-----------

[](#theme-usage)

Theme usage is simple just set theme name and set content as theme template array.

```
Amaran::theme('awesome ok')->content([
        'title'=>'My first funcy example!',
        'message'=>'1.4 GB',
        'info'=>'my_birthday.mp4',
        'icon'=>'fa fa-download'
    ])->create();
```

> Little note if you want to use awesome theme you have to include [font awesome](http://fortawesome.github.io/Font-Awesome/icons/).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.5% 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 ~514 days

Total

2

Last Release

3254d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0d29dad8e4c61100b1a5deb41521edf06673142a6f5a934cb473bf334d007fcb?d=identicon)[xuma](/maintainers/xuma)

---

Top Contributors

[![hakanersu](https://avatars.githubusercontent.com/u/1052467?v=4)](https://github.com/hakanersu "hakanersu (39 commits)")[![nicozimmermann94](https://avatars.githubusercontent.com/u/9193934?v=4)](https://github.com/nicozimmermann94 "nicozimmermann94 (1 commits)")

---

Tags

jquerylaravelnotificationlaravelnotificationstylish

### Embed Badge

![Health badge](/badges/xuma-laravel-amaran/health.svg)

```
[![Health](https://phpackages.com/badges/xuma-laravel-amaran/health.svg)](https://phpackages.com/packages/xuma-laravel-amaran)
```

###  Alternatives

[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[mckenziearts/laravel-notify

Flexible flash notifications for Laravel

1.7k1.1M5](/packages/mckenziearts-laravel-notify)[laravel-notification-channels/twilio

Provides Twilio notification channel for Laravel

2587.7M12](/packages/laravel-notification-channels-twilio)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[brian2694/laravel-toastr

toastr.js for Laravel

136649.4k5](/packages/brian2694-laravel-toastr)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)

PHPackages © 2026

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