PHPackages                             vectorwyse/idle-timeout-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. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. vectorwyse/idle-timeout-alert

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

vectorwyse/idle-timeout-alert
=============================

A Laravel package for alerting idle sessions about to expire.

v1.0(5y ago)67371[2 issues](https://github.com/vectorwyse/idle-timeout-alert/issues)MITVue

Since Jul 7Pushed 5y ago1 watchersCompare

[ Source](https://github.com/vectorwyse/idle-timeout-alert)[ Packagist](https://packagist.org/packages/vectorwyse/idle-timeout-alert)[ RSS](/packages/vectorwyse-idle-timeout-alert/feed)WikiDiscussions master Synced 1mo ago

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

Idle Timeout Alert
==================

[](#idle-timeout-alert)

> A Laravel package for alerting idle sessions about to expire.

SESSION\_LIFETIME is great but how is the user supposed to know when the session is about to expire due to inactivity, especially if it is a low value? Furthermore, a user may be actively engaging the site (by clicking around or filling out a form) without ever sending a request to the backend. Laravel may end the session during this time without the user knowing.

When the session is about to expire, show a dialog so the user can choose not to be logged out.

[![](screenshot.png)](screenshot.png)

How it works
------------

[](#how-it-works)

This code doesn't actually log the user out. It still relies on Laravel's mechanism for expiring sessions. All it does is periodically check how much time before the session will expire and alert the user when it is almost time.

A demo library is at [vectorwyse/idle-timeout-alert-demo](https://github.com/vectorwyse/idle-timeout-alert-demo)

Installation
------------

[](#installation)

Laravel package and NPM dependencies

```
composer require vectorwyse/idle-timeout-alert
npm install --save idle-vue
```

Usage
-----

[](#usage)

### Disable "Remember Me" functionality

[](#disable-remember-me-functionality)

Step 1: Add the following line to `app/User.php`:

```
protected $rememberTokenName = false;
```

Step 2: Remove the "Remember Me" checkbox from your login form

### Publish and compile assets

[](#publish-and-compile-assets)

Step 1: Publish assets to vendor folder:

```
php artisan vendor:publish --provider="Vectorwyse\IdleTimeoutAlert\IdleTimeoutAlertServiceProvider" --tag="vue-components"
```

Step 2: Add the following to your application's `resources/js/app.js`. Place within section where components are registered:

```
require('./../assets/vendor/vectorwyse/idle-timeout-alert/js/app');
```

Step 3: Compile

```
npm run dev
```

### Add component

[](#add-component)

Finally, add the component to any page where you would like the dialog. A good place is `layouts/app.blade.php`.

```

```

By default the dialog will only appear if the user happens to be idle when the session is about to expire. As long as user has activity, a ping will be sent in the background keeping the session alive.

If you would like to ignore user activity and have the dialog appear no matter what, then use the following:

```

```

If you want to allow a user to be on a particular page forever without ever timing out, then use the following:

```

```

As long as user is on the page, a ping will be sent in the background keeping the session alive and no dialog will ever appear.

Customization
-------------

[](#customization)

Feel free to make changes to the dialog in `resources/assets/vendor/vectorwyse/idle-timeout-alert/js/components/TimeoutDialog.vue`. Don't forget to recompile assets afterward!

Support Us
----------

[](#support-us)

[Vectorwyse](https://vectorwyse.com) is a digital agency offering advisory and web development services. We love building things with Laravel and Vue.js, so when we have an opportunity to give back to the community, we're super excited!

If you find this package useful, or if you would like us to build something for you, feel free to [drop us a line!](mailto:hello@vectorwyse.com)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity55

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

Unknown

Total

1

Last Release

2142d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4dcf578e60ccbe9e62ece1c56df737c8a5bddb421a124b8eabc0d8e8b23e6136?d=identicon)[vectorwyse](/maintainers/vectorwyse)

---

Top Contributors

[![jelib3an](https://avatars.githubusercontent.com/u/50533338?v=4)](https://github.com/jelib3an "jelib3an (12 commits)")

### Embed Badge

![Health badge](/badges/vectorwyse-idle-timeout-alert/health.svg)

```
[![Health](https://phpackages.com/badges/vectorwyse-idle-timeout-alert/health.svg)](https://phpackages.com/packages/vectorwyse-idle-timeout-alert)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[gesdinet/jwt-refresh-token-bundle

Implements a refresh token system over Json Web Tokens in Symfony

70516.4M35](/packages/gesdinet-jwt-refresh-token-bundle)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[beatswitch/lock

A flexible, driver based Acl package for PHP 5.4+

870304.7k2](/packages/beatswitch-lock)[amocrm/amocrm-api-library

amoCRM API Client

182728.5k6](/packages/amocrm-amocrm-api-library)[vonage/jwt

A standalone package for creating JWTs for Vonage APIs

424.1M4](/packages/vonage-jwt)

PHPackages © 2026

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