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(6mo ago)124272.7k↓46.6%16[2 PRs](https://github.com/CodeWithDennis/filament-simple-alert/pulls)2MITPHPPHP ^8.1CI passing

Since Jun 27Pushed 1mo 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 2w 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.

[![filament-simple-alert-light-mint-3840x2160](https://private-user-images.githubusercontent.com/23448484/616880573-446bb6d3-8043-4b72-99d3-71cc93577e4f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODU1MjkyMDYsIm5iZiI6MTc4NTUyODkwNiwicGF0aCI6Ii8yMzQ0ODQ4NC82MTY4ODA1NzMtNDQ2YmI2ZDMtODA0My00YjcyLTk5ZDMtNzFjYzkzNTc3ZTRmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MzElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzMxVDIwMTUwNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWU1MmU1OTE4OWE2YTI5YmU0ODY4MTAwNDVhNjM3MWVkNjcyMjE5MDgzODNhNWYxN2EyZGY2YWI2YmY3MTMzMmUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.S65BDuO0FXGULd6CaZXlBtLGdWcJ8JRrVfMzgh1jJao)](https://private-user-images.githubusercontent.com/23448484/616880573-446bb6d3-8043-4b72-99d3-71cc93577e4f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODU1MjkyMDYsIm5iZiI6MTc4NTUyODkwNiwicGF0aCI6Ii8yMzQ0ODQ4NC82MTY4ODA1NzMtNDQ2YmI2ZDMtODA0My00YjcyLTk5ZDMtNzFjYzkzNTc3ZTRmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA3MzElMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNzMxVDIwMTUwNlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWU1MmU1OTE4OWE2YTI5YmU0ODY4MTAwNDVhNjM3MWVkNjcyMjE5MDgzODNhNWYxN2EyZGY2YWI2YmY3MTMzMmUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.S65BDuO0FXGULd6CaZXlBtLGdWcJ8JRrVfMzgh1jJao)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

58

—

FairBetter than 98% of packages

Maintenance80

Actively maintained with recent releases

Popularity51

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 63.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 ~24 days

Recently: every ~40 days

Total

32

Last Release

45d 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 (94 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

[backstage/mails

View logged mails and events in a beautiful Filament UI.

16429.7k](/packages/backstage-mails)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3915.5k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

123204.9k1](/packages/stephenjude-filament-feature-flags)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

94160.6k6](/packages/marcelweidum-filament-expiration-notice)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

85240.3k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6758.2k2](/packages/marcelweidum-filament-passkeys)

PHPackages © 2026

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