PHPackages cookiemc337/filament-progress-column - 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. [Admin Panels](/categories/admin) 4. / 5. cookiemc337/filament-progress-column ActiveLibrary[Admin Panels](/categories/admin) cookiemc337/filament-progress-column ==================================== Add a progress bar column to your Filament tables. 1.0.2(2y ago)07MITPHPPHP ^8.2 Since Apr 18Pushed 2y agoCompare [ Source](https://github.com/CookieMC337/filament-progress-column)[ Packagist](https://packagist.org/packages/cookiemc337/filament-progress-column)[ Docs](https://github.com/cookiemc337/filament-progress-column)[ GitHub Sponsors](https://github.com/ryangjchandler)[ RSS](/packages/cookiemc337-filament-progress-column/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (13)Versions (4)Used By (0) Add a progress bar column to your Filament tables. ================================================== [](#add-a-progress-bar-column-to-your-filament-tables) [![Latest Version on Packagist](https://camo.githubusercontent.com/55a75751c019a119265c6b2d1ab091ebb5b9912b956afe827c2f384eaa243322/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f6f6b69656d633333372f66696c616d656e742d70726f67726573732d636f6c756d6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cookiemc337/filament-progress-column)[![GitHub Tests Action Status](https://camo.githubusercontent.com/af57ba613f4ffbcd7cd5d9515040536d96a7f835312fec689370a353f7aae107/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f636f6f6b69656d633333372f66696c616d656e742d70726f67726573732d636f6c756d6e2f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/cookiemc337/filament-progress-column/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/5f3a7a2b782699072bf2c856875990352104c5403ddf956d08b740304cf1f987/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f636f6f6b69656d633333372f66696c616d656e742d70726f67726573732d636f6c756d6e2f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/cookiemc337/filament-progress-column/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/a46b2f5183d1dc39861dbf29a3f1f76040fa124d6adcb7030c5548b08dfb1e06/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7279616e676a6368616e646c65722f66696c616d656e742d70726f67726573732d636f6c756d6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cookiemc337/filament-progress-column) This package provides a `ProgessColumn` that can be used to display a progress bar in a Filament table. Installation ------------ [](#installation) You can install the package via Composer: ``` composer require cookiemc337/filament-progress-column ``` If you're **not** using the `filament/admin` package, you should also add the following line to the top of your CSS: ``` @import '../../vendor/cookiemc337/filament-progress-column/resources/dist/progress.css' ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="filament-progress-column-views" ``` Usage ----- [](#usage) Add the `ProgressColumn` to your table: ``` use CookieMC337\FilamentProgressColumn\ProgressColumn; protected function getTableColumns(): array { return [ ProgressColumn::make('progress'), ]; } ``` This will render a progress bar and used the value of `$record->progress` as the current progress. [![](art/screenshot.jpeg)](art/screenshot.jpeg) ### Dynamic progress calculation [](#dynamic-progress-calculation) If you wish to calculate the progress dynamically, provide a `Closure` to the `ProgressColumn::progress()` method. ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress') ->progress(function ($record) { return ($record->rows_complete / $record->total_rows) * 100; }), ]; } ``` ### Polling [](#polling) If you would like your progress bar to update after a period of time, call the `ProgressBar::poll()` method and provide a valid modifier string for the `wire:poll` directive. ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress') ->poll('5s') ]; } ``` This will result in a `wire:poll.5s` directive being added to the column and the value of your progress bar will update every 5 seconds. #### Dynamic polling [](#dynamic-polling) There might be scenarios where you only want to poll if some condition is met. This can be achieved by returning `?string` from a `Closure`. ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress') ->poll(function ($record) { return $record->progress < 100 ? '5s' : null; }) ]; } ``` Now the progress bar will only be updated every 5 seconds **if** the progress is less than 100. ### Colors [](#colors) By default, the progress bar will be the same as your `primary` color. If you wish to change this, provide a new string to `ProgressBar::color()`. ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress') ->color('warning'), ]; } ``` With a [custom filament theme](https://filamentphp.com/docs/2.x/admin/appearance#building-themes) you can add `'./app/Filament/Resources/*.php'` to the `content` section in `tailwind.config.js` so colors won't get purged and create [gradient colors](https://tailwindcss.com/docs/gradient-color-stops#middle-color) like ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress') ->color('bg-gradient-to-r from-indigo-500 via-purple-500 to-pink-500'), ]; } ``` ### Dynamic color calculation [](#dynamic-color-calculation) If you wish to calculate the color dynamically, provide a `Closure` to the `ProgressColumn::color()` method. ``` protected function getTableColumns(): array { return [ ProgressColumn::make('progress')->color(function ($record){ return $record->progress > 50 ? 'primary' : 'success'; }) ]; } ``` Testing ------- [](#testing) ``` composer test ``` 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) - [Ryan Chandler](https://github.com/ryangjchandler) - [CookieMC337](https://github.com/CookieMC337). - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 25 — LowBetter than 35% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community12 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 3 Last Release 806d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7cf1d6d8d7218eeace3f50fe0bd639ba0774f199124f3ad250aa63d117bebc95?d=identicon)[CookieMC337](/maintainers/CookieMC337) --- Top Contributors [![ryangjchandler](https://avatars.githubusercontent.com/u/41837763?v=4)](https://github.com/ryangjchandler "ryangjchandler (27 commits)")[![CookieMC337](https://avatars.githubusercontent.com/u/51511368?v=4)](https://github.com/CookieMC337 "CookieMC337 (12 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")[![simonbuehler](https://avatars.githubusercontent.com/u/78061?v=4)](https://github.com/simonbuehler "simonbuehler (2 commits)")[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (1 commits)")[![Sicklou](https://avatars.githubusercontent.com/u/8366863?v=4)](https://github.com/Sicklou "Sicklou (1 commits)") --- Tags laravelryangjchandlerfilament-progress-column ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/cookiemc337-filament-progress-column/health.svg) ``` [![Health](https://phpackages.com/badges/cookiemc337-filament-progress-column/health.svg)](https://phpackages.com/packages/cookiemc337-filament-progress-column) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M47](/packages/spatie-laravel-pdf)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger About 104162.2k2](/packages/stephenjude-filament-debugger)[croustibat/filament-jobs-monitor Background Jobs monitoring like Horizon for all drivers for FilamentPHP 274325.8k8](/packages/croustibat-filament-jobs-monitor)[guava/filament-knowledge-base A filament plugin that adds a knowledge base and help to your filament panel(s). 209151.3k2](/packages/guava-filament-knowledge-base) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)