PHPackages ryangjchandler/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. [Utility & Helpers](/categories/utility) 4. / 5. ryangjchandler/filament-progress-column ActiveLibrary[Utility & Helpers](/categories/utility) ryangjchandler/filament-progress-column ======================================= Add a progress bar column to your Filament tables. v2.1.0(2mo ago)68137.3k↓51.7%9[1 issues](https://github.com/ryangjchandler/filament-progress-column/issues)[1 PRs](https://github.com/ryangjchandler/filament-progress-column/pulls)1MITPHPPHP ^8.2CI passing Since May 29Pushed 2mo ago3 watchersCompare [ Source](https://github.com/ryangjchandler/filament-progress-column)[ Packagist](https://packagist.org/packages/ryangjchandler/filament-progress-column)[ Docs](https://github.com/ryangjchandler/filament-progress-column)[ GitHub Sponsors](https://github.com/ryangjchandler)[ RSS](/packages/ryangjchandler-filament-progress-column/feed)WikiDiscussions main Synced today READMEChangelog (10)Dependencies (26)Versions (15)Used By (1) 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/30bc6279bbe76c68d6fd43e2202051872f42703ca41443c2523c039e0d33f7f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7279616e676a6368616e646c65722f66696c616d656e742d70726f67726573732d636f6c756d6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ryangjchandler/filament-progress-column)[![GitHub Tests Action Status](https://camo.githubusercontent.com/38fbfb992ec9bff96178e801641048dd54f494fca4327f43e801c883ab58a072/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7279616e676a6368616e646c65722f66696c616d656e742d70726f67726573732d636f6c756d6e2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473)](https://github.com/ryangjchandler/filament-progress-column/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/f893cb345e70ed982de1647da9a8e180fdf5288da231b360fc7b2711be362d0a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7279616e676a6368616e646c65722f66696c616d656e742d70726f67726573732d636f6c756d6e2f7068702d63732d66697865722e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65)](https://github.com/ryangjchandler/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/ryangjchandler/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 ryangjchandler/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/ryangjchandler/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 RyanChandler\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) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 60 — FairBetter than 98% of packages Maintenance88 Actively maintained with recent releases Popularity47 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 50.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 ~130 days Recently: every ~192 days Total 12 Last Release 60d ago Major Versions v0.4.1 → v1.0.02024-03-25 1.x-dev → v2.0.02025-08-15 PHP version history (3 changes)v0.1.0PHP ^8.0 v0.4.0PHP ^8.1 v1.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/568d485d441c691b0358b9091254a6a671fef8f76b73f28af1180ad568d142b2?d=identicon)[ryangjchandler](/maintainers/ryangjchandler) --- Top Contributors [![ryangjchandler](https://avatars.githubusercontent.com/u/41837763?v=4)](https://github.com/ryangjchandler "ryangjchandler (28 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)")[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (5 commits)")[![johanmolen](https://avatars.githubusercontent.com/u/8382746?v=4)](https://github.com/johanmolen "johanmolen (2 commits)")[![simonbuehler](https://avatars.githubusercontent.com/u/78061?v=4)](https://github.com/simonbuehler "simonbuehler (2 commits)")[![Sicklou](https://avatars.githubusercontent.com/u/8366863?v=4)](https://github.com/Sicklou "Sicklou (2 commits)")[![JonPurvis](https://avatars.githubusercontent.com/u/7534029?v=4)](https://github.com/JonPurvis "JonPurvis (1 commits)")[![blazerunner44](https://avatars.githubusercontent.com/u/12058167?v=4)](https://github.com/blazerunner44 "blazerunner44 (1 commits)") --- Tags laravelryangjchandlerfilament-progress-column ### Code Quality TestsPest Static AnalysisPHPStan ### Embed Badge ![Health badge](/badges/ryangjchandler-filament-progress-column/health.svg) ``` [![Health](https://phpackages.com/badges/ryangjchandler-filament-progress-column/health.svg)](https://phpackages.com/packages/ryangjchandler-filament-progress-column) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[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)[codewithdennis/filament-select-tree The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths. 329530.5k29](/packages/codewithdennis-filament-select-tree)[stephenjude/filament-feature-flags Filament implementation of feature flags and segmentation with Laravel Pennant. 122177.8k1](/packages/stephenjude-filament-feature-flags)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 284.5k1](/packages/finity-labs-fin-mail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)