PHPackages                             awcodes/shout - 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. awcodes/shout

ActiveLibrary

awcodes/shout
=============

A simple inline contextual notice for Filament forms, basically just a fancy placeholder.

v4.0.0(3mo ago)70446.5k—2.3%13[1 PRs](https://github.com/awcodes/shout/pulls)5MITPHPPHP ^8.2CI passing

Since Apr 13Pushed 2mo ago3 watchersCompare

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

READMEChangelog (10)Dependencies (9)Versions (23)Used By (5)

Shout
=====

[](#shout)

A simple inline contextual notice for Filament forms and infolist, basically just a fancy placeholder.

[![Latest Version](https://camo.githubusercontent.com/85ea461d1327093ca05c9b3c898ec52fa38b0ce8c1a7c85776d90f8771f4f25c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6177636f6465732f73686f75742e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d52656c65617365)](https://github.com/awcodes/shout/releases)[![MIT Licensed](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/bb5e6d0116266e323f6109e668ac9ae236c232bb3586488499bfc7adce11a811/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f73686f75742e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/awcodes/shout)[![GitHub Repo stars](https://camo.githubusercontent.com/31f0a831c7aa03e86b7ab98cf3d9d0d67e2669f67d5f2157eadf37da5ab63daf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6177636f6465732f73686f75743f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d5374617273)](https://github.com/awcodes/shout/stargazers)

Compatibility
-------------

[](#compatibility)

Package VersionFilament Version1.x2.x2.x3.x3.x4.x4.x5.xInstallation
------------

[](#installation)

You can install the package via composer:

```
composer require awcodes/shout
```

Important

If you have not set up a custom theme and are using Filament Panels follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first.

After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages.

```
@source '../../../../vendor/awcodes/shout/resources/**/*.blade.php';
```

Usage
-----

[](#usage)

Simply include the component in any of your form or infolists `schema()` methods.

```
use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
```

Custom Colors
-------------

[](#custom-colors)

You can use the `color()` method to set a custom color using Filament's Color Object.

```
use Awcodes\Shout\Components\Shout;
use Filament\Support\Colors\Color;

Shout::make('so-important')
    ->content('This is a test')
    ->color(Color::Lime)

Shout::make('so-important')
    ->content('This is a test')
    ->color(Color::hex('#badA55'))
```

Icons
-----

[](#icons)

### Changing the icon

[](#changing-the-icon)

```
use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->icon('heroicon-s-circle-check')
```

### Icon Size

[](#icon-size)

```
use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->iconSize('sm|md|lg|xl')
```

### Disabling the icon

[](#disabling-the-icon)

```
use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->icon(false)
```

Headings
--------

[](#headings)

You can add a heading to your shout using the `heading()` method. By default , the heading will be a h2 element, but you can override this by using an `HtmlString` object.

```
use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->heading('Important Notice')
    ->content('This is a test')
```

Actions
-------

[](#actions)

You can add actions to your shout using the `actions()` method. This accepts an array of Filament Action objects.

```
use Awcodes\Shout\Components\Shout;
use Filament\Forms\Components\Actions\Action;

Shout::make('so-important')
    ->content('This is a test')
    ->actions([
        Action::make('action1')
            ->label('Action 1')
            ->url('https://example.com'),
        Action::make('action2')
            ->label('Action 2')
            ->url('https://example.com'),
    ])
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

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

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Adam Weston](https://github.com/awcodes)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

60

—

FairBetter than 99% of packages

Maintenance82

Actively maintained with recent releases

Popularity51

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 54.9% 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 ~52 days

Total

21

Last Release

77d ago

Major Versions

v1.0.1 → v2.0.0-alpha12023-06-13

1.x-dev → v2.0.0-alpha22023-07-05

v2.1.0 → v3.0.0-beta.12025-05-31

2.x-dev → v3.0.02025-08-12

3.x-dev → v4.0.02026-01-19

PHP version history (3 changes)v1.0.0PHP ^8.0

v2.0.0-alpha2PHP ^8.1

v3.0.0-beta.2PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes)

---

Top Contributors

[![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (39 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (19 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")[![ConnorHowell](https://avatars.githubusercontent.com/u/4037845?v=4)](https://github.com/ConnorHowell "ConnorHowell (1 commits)")[![sadegh19b](https://avatars.githubusercontent.com/u/54643531?v=4)](https://github.com/sadegh19b "sadegh19b (1 commits)")

---

Tags

filamentfilament-pluginfilamentawcodesshout

###  Code Quality

TestsPest

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/awcodes-shout/health.svg)

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

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[awcodes/filament-curator

A media picker plugin for FilamentPHP.

434297.7k19](/packages/awcodes-filament-curator)[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

246177.6k7](/packages/awcodes-filament-quick-create)[ysfkaya/filament-phone-input

A phone input component for Laravel Filament

299998.0k20](/packages/ysfkaya-filament-phone-input)[shuvroroy/filament-spatie-laravel-backup

This plugin is built on top of Spatie's Laravel-backup package

268356.4k6](/packages/shuvroroy-filament-spatie-laravel-backup)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)

PHPackages © 2026

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