PHPackages                             codewithdennis/filament-simple-alert - 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. codewithdennis/filament-simple-alert

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

codewithdennis/filament-simple-alert
====================================

A plugin for adding straightforward alerts to your filament pages

v4.0.5(3mo ago)123208.5k—9.6%16[2 PRs](https://github.com/CodeWithDennis/filament-simple-alert/pulls)2MITPHPPHP ^8.1CI passing

Since Jun 27Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/CodeWithDennis/filament-simple-alert)[ Packagist](https://packagist.org/packages/codewithdennis/filament-simple-alert)[ Docs](https://github.com/codewithdennis/filament-simple-alert)[ GitHub Sponsors](https://github.com/CodeWithDennis)[ RSS](/packages/codewithdennis-filament-simple-alert/feed)WikiDiscussions 4.x Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (32)Used By (2)

Filament Simple Alert
=====================

[](#filament-simple-alert)

[![Latest Version on Packagist](https://camo.githubusercontent.com/36db2c37e2208773551cbf45a4e467f89aaf161b0005ba21303c623fa3491708/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64657769746864656e6e69732f66696c616d656e742d73696d706c652d616c6572742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codewithdennis/filament-simple-alert)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/191037a86033b381b3e66809cce85d5de1f0dcbd650e7b589529e61b73c0115c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f64657769746864656e6e69732f66696c616d656e742d73696d706c652d616c6572742f70696e742e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/codewithdennis/filament-simple-alert/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/50bcee5dcfbe7b7e78473b52347b1ab901dd5c3ff2afbce6952f007460bc0e86/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f64657769746864656e6e69732f66696c616d656e742d73696d706c652d616c6572742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/codewithdennis/filament-simple-alert)

If you're using Filament `3.x`, check out the compatible version of this [package here](https://github.com/CodeWithDennis/filament-simple-alert/tree/3.x).

This package offers a straightforward and easy-to-use alert component for your Filament application. It allows you to quickly implement customizable alert messages, enhancing the user experience by providing clear and concise notifications.

[![Simple Alert](https://github.com/CodeWithDennis/filament-simple-alert/raw/4.x/resources/screenshots/thumbnail.png)](https://github.com/CodeWithDennis/filament-simple-alert/raw/4.x/resources/screenshots/thumbnail.png)

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

[](#installation)

You can install the package via composer:

```
composer require codewithdennis/filament-simple-alert:4.x
```

### Custom Theme

[](#custom-theme)

You will need to [create a custom theme](https://filamentphp.com/docs/3.x/panels/themes#creating-a-custom-theme) for the styles to be applied correctly.

Make sure you add the following to your `theme.css` file.

```
@source '../../../../vendor/codewithdennis/filament-simple-alert/resources/**/*.blade.php';
@source inline('animate-{spin,pulse,bounce}');
```

Usage
-----

[](#usage)

Make sure to import the `SimpleAlert` component at the top of your file:

```
use CodeWithDennis\SimpleAlert\Components\SimpleAlert;
```

### Predefined Alerts

[](#predefined-alerts)

There are 4 types predefined of simple alerts: `danger`, `info`, `success`, and `warning`.

```
SimpleAlert::make('example')
    ->danger()
    ->info()
    ->success()
    ->warning()
```

If you would like to use a [different color](https://filamentphp.com/docs/3.x/support/colors), you can use the `color` method.

```
SimpleAlert::make('example')
    ->color('purple')
```

### Icon

[](#icon)

By default, simple alerts come with an icon. For example, the `->danger()` method includes a `heroicon-s-x-circle` icon. If you want to use a different icon, you can use the icon method.

```
SimpleAlert::make('example')
    ->color('purple')
    ->icon('heroicon-s-users')
```

Or you can use a custom icon by passing an HTML string or a Blade component to the `icon` method.

```
SimpleAlert::make('example')
    ->icon(new HtmlString('🤓'))
    ->icon(new HtmlString(Blade::render('my-custom-icon-component')))
```

#### Icon Animation

[](#icon-animation)

You can add animation to the icon by passing the animation type as the second parameter to the `icon` method. Make sure to use the `IconAnimation` enum for the animation type.

```
use CodeWithDennis\SimpleAlert\Components\Enums\IconAnimation;

SimpleAlert::make('example')
    ->icon('heroicon-s-arrow-path', IconAnimation::Spin)
```

#### Icon Vertical Alignment

[](#icon-vertical-alignment)

You can change the vertical alignment of the icon by using the `iconVerticalAlignment` method.

```
SimpleAlert::make('example')
    ->iconVerticalAlignment('start'), // possible values: start, center
```

### Title

[](#title)

You can add a title to the alert by using the `title` method.

```
SimpleAlert::make('example')
    ->title('Hoorraayy! Your request has been approved! 🎉')
```

### Description

[](#description)

You can add a description to the alert by using the `description` method.

```
SimpleAlert::make('example')
    ->description('This is the description')
```

### Border

[](#border)

You can add a border to the alert by using the `border` method.

```
SimpleAlert::make('example')
    ->border()
```

### Actions

[](#actions)

You can also add actions to the alert by using the `actions` method. All regular action features are supported.

```
use Filament\Actions\Action;

SimpleAlert::make('example')
    ->columnSpanFull()
    ->success()
    ->title('Simple Alert')
    ->description('This is an example of a simple alert.')
    ->actions([
        Action::make('read-example')
            ->label('Read more')
            ->url('https://filamentphp.com')
            ->openUrlInNewTab()
            ->color('info'),
    ]),
```

#### Actions Vertical Alignment

[](#actions-vertical-alignment)

You can change the vertical alignment of the actions by using the `actionsVerticalAlignment` method.

```
use Filament\Actions\Action;

SimpleAlert::make('example')
    ->actionsVerticalAlignment('start'), // possible values: start, center
```

### Example

[](#example)

```
use Filament\Actions\Action;

SimpleAlert::make('example')
    ->success()
    ->title(new HtmlString('Hoorraayy! Your request has been approved! 🎉'))
    ->description('Lorem ipsum dolor sit amet consectetur adipisicing elit.')
    ->actions([
         Action::make('filament')
            ->label('Details')
            ->icon('heroicon-m-arrow-long-right')
            ->iconPosition(IconPosition::After)
            ->link()
            ->url('https://filamentphp.com')
            ->openUrlInNewTab()
            ->color('success'),
    ]),
```

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

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [CodeWithDennis](https://github.com/CodeWithDennis)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance79

Regular maintenance activity

Popularity51

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 63.3% 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 ~18 days

Recently: every ~1 days

Total

32

Last Release

111d ago

Major Versions

v3.0.19 → v4.0.0-beta.12025-06-18

v3.0.20 → v4.0.0-beta.22025-06-21

v3.0.21 → v4.0.42026-01-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/6d47a56dfab94e67a7354a146f96a0285c09f6b9d649c558832c6a9b94354b8c?d=identicon)[CodeWithDennis](/maintainers/CodeWithDennis)

---

Top Contributors

[![CodeWithDennis](https://avatars.githubusercontent.com/u/23448484?v=4)](https://github.com/CodeWithDennis "CodeWithDennis (93 commits)")[![dissto](https://avatars.githubusercontent.com/u/11778632?v=4)](https://github.com/dissto "dissto (39 commits)")[![MarcelWeidum](https://avatars.githubusercontent.com/u/9413586?v=4)](https://github.com/MarcelWeidum "MarcelWeidum (6 commits)")[![andrewdwallo](https://avatars.githubusercontent.com/u/104294090?v=4)](https://github.com/andrewdwallo "andrewdwallo (3 commits)")[![thursdaydan](https://avatars.githubusercontent.com/u/8914312?v=4)](https://github.com/thursdaydan "thursdaydan (2 commits)")[![howdu](https://avatars.githubusercontent.com/u/533658?v=4)](https://github.com/howdu "howdu (1 commits)")[![sadegh19b](https://avatars.githubusercontent.com/u/54643531?v=4)](https://github.com/sadegh19b "sadegh19b (1 commits)")[![schaper1337](https://avatars.githubusercontent.com/u/76951291?v=4)](https://github.com/schaper1337 "schaper1337 (1 commits)")[![tizianozonta](https://avatars.githubusercontent.com/u/219696?v=4)](https://github.com/tizianozonta "tizianozonta (1 commits)")

---

Tags

alertalertsfilamentfilament-pluginfilamentphpfilamentphp-3filamentphp-4filamentphp-pluginlaravellivewirepackagephppluginlaravelCodeWithDennisfilament-simple-alert

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/codewithdennis-filament-simple-alert/health.svg)

```
[![Health](https://phpackages.com/badges/codewithdennis-filament-simple-alert/health.svg)](https://phpackages.com/packages/codewithdennis-filament-simple-alert)
```

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

9169.0k4](/packages/marcelweidum-filament-expiration-notice)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)[outerweb/filament-settings

Filament integration for the outerweb/settings package

3690.9k4](/packages/outerweb-filament-settings)

PHPackages © 2026

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