PHPackages                             kazeeem/laravel-flexible-countdown - 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 &amp; Helpers](/categories/utility)
4. /
5. kazeeem/laravel-flexible-countdown

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

kazeeem/laravel-flexible-countdown
==================================

This Laravel package allows you to create countdown timer on the go. It's very easy to use and understand and modify.

v1.0.1(4y ago)140mitHTML

Since Nov 10Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Kazeeem/laravel-flexible-countdown)[ Packagist](https://packagist.org/packages/kazeeem/laravel-flexible-countdown)[ RSS](/packages/kazeeem-laravel-flexible-countdown/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

 [![Flexible Countdown](https://camo.githubusercontent.com/2c8203e17777b4e363df13e5847b3e6289465b43c3edeef1da45ea25f6d7e331/68747470733a2f2f636f64696e676b617a2e636f6d2e6e672f696d616765732f636f756e74646f776e2e676966)](https://codingkaz.com.ng)
 Flexible Countdown (Laravel)

=====================================================================================================================================================================================================================================================================================

[](#--------flexible-countdown-laravel--)

#### Flexible Countdown is a special countdown timer for Laravel built on [DayJs Library](https://day.js.org/).

[](#flexible-countdown-is-a-special-countdown-timer-for-laravel-built-on-dayjs-library)

 [ ![](https://camo.githubusercontent.com/ec88d65596d673342c1fb8e2606c623152c6ce264af059599587182385988490/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f4b617a6565656d2f6c61726176656c2d666c657869626c652d636f756e74646f776e3f6c6162656c3d4c617465737425323052656c65617365) ](https://img.shields.io/github/v/release/Kazeeem/laravel-flexible-countdown?label=Latest%20Release) [ ![](https://camo.githubusercontent.com/08d55226b359e5025e3a4d6b5ca13cdd8d8ae5d123fe101266d69aa64859b64f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f4b617a6565656d2f6c61726176656c2d666c657869626c652d636f756e74646f776e) ](https://img.shields.io/github/last-commit/Kazeeem/laravel-flexible-countdown) [ ![](https://camo.githubusercontent.com/4bbff6bc3889caf0b2d6c6d8d7b1368423f404ffa0d2fbc869444e545b292287/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f4b617a6565656d2f6c61726176656c2d666c657869626c652d636f756e74646f776e3f7374796c653d736f6369616c) ](https://img.shields.io/github/forks/Kazeeem/laravel-flexible-countdown?style=social) [ ![](https://camo.githubusercontent.com/3e3c0b3dde23f9dcb4da333879431db070107eddda12a5c8950a822f50fef4d5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4b617a6565656d2f6c61726176656c2d666c657869626c652d636f756e74646f776e) ](https://img.shields.io/github/license/Kazeeem/laravel-flexible-countdown)

[![made-with-javascript](https://camo.githubusercontent.com/422f0cbff47d3706fda18ae57bf62f4ced744635f019eded777f43b6f005c3e4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d616465253230776974682d4a6176615363726970742d3166343235662e737667)](https://www.javascript.com)

 [Key Features](#key-features) • [How To Use](#how-to-use) • [Credits](#credits) • [License](#license)

Key Features
------------

[](#key-features)

- Locale support
    - You can specify the time in your timezone.
- Action to perform when timer elapses
    - You could either display a message or reload the page when the time reaches zero.
- Countdown in various formats. (i.e Year, months, weeks, days, hour, minutes and seconds.
- Easy to modify.

How To Use
----------

[](#how-to-use)

This package requires the use of [Jquery 3.6.0 and above](https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js)

```
# Install via Composer
* composer require kazeeem/laravel-flexible-countdown

# Optional: The service provider will automatically get registered. Or you may manually add the service provider in your config/app.php file:
*   'providers' => [
        // ...
        Kazeeem\FlexibleCountdown\FlexibleCountdownServiceProvider::class,
    ];

# Publish the asset
$ Run this artisan command:
* php artisan vendor:publish --tag=public --force
```

[![screenshot](https://camo.githubusercontent.com/2c28dd736212e5c79fd21e82302e04490599187e1d2c996fee3be78d35dd63d0/68747470733a2f2f636f64696e676b617a2e636f6d2e6e672f696d616765732f636172626f6e2e706e67)](https://camo.githubusercontent.com/2c28dd736212e5c79fd21e82302e04490599187e1d2c996fee3be78d35dd63d0/68747470733a2f2f636f64696e676b617a2e636f6d2e6e672f696d616765732f636172626f6e2e706e67)

You can create a countdown timer as it is in the sample above
=============================================================

[](#you-can-create-a-countdown-timer-as-it-is-in-the-sample-above)

However, there are some optional parameters you may want to use as well:

- expiry\_message
    - This is the message you may want to display when the timer reaches zero. If this value is not passed, the default message is "Time Up"
- reload\_page
    - This takes the value of true or false. It reloads the page when the countdown reaches zero.
- suffix
    - This also takes the value of true or false. It will display the letters of the time beside the individual numbers
- show\_days
    - By default, the timer shows Hour, minutes and seconds but if you want it to show the value of remaining days, you can set this to true
- show\_weeks
    - If you want to show remaining weeks.
- show\_months
    - If you want to show remaining months.
- show\_years
    - If you want to show remaining year.
- local
    - You can specify the timezone you want the counter to use. By default, it is set to Africa/Lagos.

Full Sample Code
================

[](#full-sample-code)

[![screenshot](https://camo.githubusercontent.com/6e6b06f8f75dc8d87c2a5d45d5b6e0c53c8ab471740285f93dea84e7de1302fe/68747470733a2f2f636f64696e676b617a2e636f6d2e6e672f696d616765732f636172626f6e312e706e67)](https://camo.githubusercontent.com/6e6b06f8f75dc8d87c2a5d45d5b6e0c53c8ab471740285f93dea84e7de1302fe/68747470733a2f2f636f64696e676b617a2e636f6d2e6e672f696d616765732f636172626f6e312e706e67)

Credits
-------

[](#credits)

This countdown package uses the following library:

- [Dayjs](https://day.js.org/) and its plugins (Timezone and Duration).

License
-------

[](#license)

MIT

---

> [codingkaz.com.ng](https://codingkaz.com.ng) · GitHub [@Kazeeem](https://github.com/Kazeeem) · Twitter [@Kazeeem\_A](https://twitter.com/Kazeeem_A)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

1645d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0f469980a9c6588ca4d33df6f702fb52473f71a8cb368e7a106fb458cafb82da?d=identicon)[Kazeeem](/maintainers/Kazeeem)

---

Top Contributors

[![Kazeeem](https://avatars.githubusercontent.com/u/35298707?v=4)](https://github.com/Kazeeem "Kazeeem (9 commits)")

### Embed Badge

![Health badge](/badges/kazeeem-laravel-flexible-countdown/health.svg)

```
[![Health](https://phpackages.com/badges/kazeeem-laravel-flexible-countdown/health.svg)](https://phpackages.com/packages/kazeeem-laravel-flexible-countdown)
```

###  Alternatives

[responsiv/currency-plugin

Currency plugin for October CMS

171.3k1](/packages/responsiv-currency-plugin)

PHPackages © 2026

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