PHPackages                             wamesk/laravel-app-version-manager - 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. wamesk/laravel-app-version-manager

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

wamesk/laravel-app-version-manager
==================================

0.2.0(1y ago)0301PHP

Since Dec 21Pushed 1y ago2 watchersCompare

[ Source](https://github.com/wamesk/laravel-app-version-manager)[ Packagist](https://packagist.org/packages/wamesk/laravel-app-version-manager)[ RSS](/packages/wamesk-laravel-app-version-manager/feed)WikiDiscussions master Synced yesterday

READMEChangelog (5)Dependencies (1)Versions (6)Used By (1)

Laravel App Version Manager
===========================

[](#laravel-app-version-manager)

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

[](#installation)

```
composer require wamesk/laravel-app-version-manager
```

Add **LaravelAppVersionManagerProvider.php** in app.php.

```
'providers' => [
    ...
    LaravelAppVersionManager\LaravelAppVersionManagerProvider::class,
    ...
],
```

Next step is to publish all translations, migrations and configurations. So you can change them to fit your needs.

```
php artisan vendor:publish --provider="Wame\LaravelAppVersionManager\LaravelAppVersionManagerProvider"
```

Configuration
-------------

[](#configuration)

### Translations

[](#translations)

You can find translations here.

You can see now it has limited translations being the folders like "en"

You can create new translations by creating another folder with version-messages.php inside.

Also, you can edit existing translations if you need.

```
resourses/
    └── lang/
        └── vendor/
            └── laravel-app-version/
                ├── sk/
                │   └── version-messages.php
                ├── cz/
                │   └── version-messages.php
                └── en/
                    └── version-messages.php

```

### Migrations

[](#migrations)

You can find published migrations in migrations folder.

There isn't much to change there, but you might want to change id type if you are using different from ulid.

### Config

[](#config)

You can find published config in config folder.

In there you can find these keys that have different purposes, you can see what they are for here.

You are free to change them if you need to.

**app\_name**

This key will determine what app name will be used in response messages.

**route.prefix**

By default, this is api/v1 but if you are using perhaps api/v2 or maybe not versioning your api endpoints. You can change this to api or empty string.

Usage
-----

[](#usage)

### Header

[](#header)

This package is about app version. So it heavily focuses on api endpoints.

For this package to work you need to be sending **app-version** header in each request you cover with middleware.

### Middleware

[](#middleware)

This middleware needs to cover every api endpoint you are using in your app.

Like mentioned above you need to be sending **app-version** header with which it will be working.

How it works: This middleware is pretty simple, takes **app-version** header, finds version in db, then it checks if version has status deprecated. If so it returns 426 response.

#### Usage

[](#usage-1)

Here is an example how to use this middleware. You can also register it globally, but in this example we will cover only route generating usage.

```
use Wame\LaravelAppVersionManager\Http\Middleware\DeprecatedVersionCheckMiddleware;

Route::group(['middleware' => DeprecatedVersionCheckMiddleware::class], function () {
    \Illuminate\Support\Facades\Route::post('login', [LoginController::class, 'login']);
});
```

### Api Endpoint

[](#api-endpoint)

This package also comes with api endpoint.

Route url is .../app-version-check, configurable in config.

If the version sent in header **app-version** is old or up to date. Endpoint will respond with 200 status code.

There will be two parameters in response:

**message** - Basic translated message that can be used to display in app.

**update** - Boolean parameter that tells if there is newer versions of app.

### Version History

[](#version-history)

Every change to app version using model will be recorded in app\_version\_history table.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance50

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 90% 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 ~139 days

Total

5

Last Release

367d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2bf6ece61ae07942df38ce88eb4053d4176c6ab0bf803191953961023f25fc70?d=identicon)[WAME](/maintainers/WAME)

---

Top Contributors

[![adrianzofcin](https://avatars.githubusercontent.com/u/75702986?v=4)](https://github.com/adrianzofcin "adrianzofcin (9 commits)")[![stanislav-cervenak](https://avatars.githubusercontent.com/u/6931349?v=4)](https://github.com/stanislav-cervenak "stanislav-cervenak (1 commits)")

---

Tags

laravelversionsappversion

### Embed Badge

![Health badge](/badges/wamesk-laravel-app-version-manager/health.svg)

```
[![Health](https://phpackages.com/badges/wamesk-laravel-app-version-manager/health.svg)](https://phpackages.com/packages/wamesk-laravel-app-version-manager)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

23.9k69.5k](/packages/grumpydictator-firefly-iii)[firefly-iii/data-importer

Firefly III Data Import Tool.

8035.8k](/packages/firefly-iii-data-importer)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17878.9k](/packages/markwalet-nova-modal-response)[ronasit/laravel-helpers

Provided helpers function and some helper class.

2085.6k31](/packages/ronasit-laravel-helpers)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1320.9k4](/packages/team-nifty-gmbh-tall-datatables)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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