PHPackages                             hulkapps/appmanager - 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. hulkapps/appmanager

ActiveLibrary

hulkapps/appmanager
===================

3.0.3(2mo ago)010.2k↓30%[2 PRs](https://github.com/HulkApps-Apps/app-manager-sdk/pulls)MITPHPPHP ^7.3|^7.4|^8.0CI failing

Since Mar 28Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/HulkApps-Apps/app-manager-sdk)[ Packagist](https://packagist.org/packages/hulkapps/appmanager)[ Docs](https://github.com/HulkApps/app-manager-sdk)[ RSS](/packages/hulkapps-appmanager/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (87)Used By (0)

App Manager SDK
===============

[](#app-manager-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/99fb3b154304bd55e9c51dde430ea1deb51b0aa43de449f2771aed000592e43c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68756c6b617070732f6170706d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hulkapps/appmanager)[![Total Downloads](https://camo.githubusercontent.com/055fe7c804e828c7ab33a489b5a641681233eb914c45dd625949f785971ce36d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68756c6b617070732f6170706d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hulkapps/appmanager)

- [Requirements](#step1)
- [Installation](#step2)
- [Configuration](#step3)
- [Usage](#step4)
- [Extras](#step5)

### Requirements

[](#requirements)

- SQLite
- Redis Server for cache (File will work too, but not recommended)

### Installation

[](#installation)

You can install the package via composer:

```
composer require hulkapps/appmanager
```

```
composer dump-autoload
```

### Configuration

[](#configuration)

#### 1.Initialize App Manager Config

[](#1initialize-app-manager-config)

```
php artisan vendor:publish --provider="HulkApps\AppManager\AppManagerServiceProvider"
```

In the case that config/app-manager.php is already present, delete it and then run the command below.

Don't forget to update secret on file `config/app-manager.php`

#### 2.Initialize App Features

[](#2initialize-app-features)

According to the example in the file, list all features of the app in `config/plan-features.php`.

Ensure you use the UIID from this [sheet](https://docs.google.com/spreadsheets/d/1cw2nSKxAHTGn4Cfa98RNdtfHT3zdtwu9bQD7s7hErXc/edit#gid=0), and don't forget to mention the app name after using the UUID

#### 3.Initialize Fail-safe Database

[](#3initialize-fail-safe-database)

Initialize MYSQL Fail-safe database in `config/database.php`

```
'app-manager-failsafe' => [
			'driver' => 'mysql',
			'host' => env('FAILSAFE_DB_HOST', '127.0.0.1'),
			'port' => env('FAILSAFE_DB_PORT', '3306'),
			'database' => env('FAILSAFE_DB_DATABASE', 'forge'),
			'username' => env('FAILSAFE_DB_USERNAME', 'forge'),
			'password' => env('FAILSAFE_DB_PASSWORD', ''),
			'unix_socket' => env('FAILSAFE_DB_SOCKET', ''),
			'charset' => 'utf8mb4',
			'collation' => 'utf8mb4_unicode_ci',
			'prefix' => '',
			'prefix_indexes' => true,
			'strict' => false,
			'engine' => null,
			'options' => extension_loaded('pdo_mysql') ? array_filter([
				PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
			]) : [],
		];
```

#### 4.Listen Plan Activation Event

[](#4listen-plan-activation-event)

Listen and Register plan activation event in `app/Providers/EventServiceProvider`.

```
use HulkApps\AppManager\app\Events\PlanActivated;

class EventServiceProvider extends ServiceProvider {
    protected $listen = [
		PlanActivated::class => [
			PlanActivatedListener::class,
		],
	];
}
```

### Usage

[](#usage)

Plan and feature helper functions are provided in this package.

##### Bind trait with user model

[](#bind-trait-with-user-model)

```
use HulkApps\AppManager\app\Traits\HasPlan;

class User extends Model
{
	use HasPlan;
}
```

##### Helper functions

[](#helper-functions)

```
$user->hasPlan(); // If the user has plan or not

$user->planFeatures(); // Return the active plan's features with value

$user->hasFeature($featureSlug); // Return the user has given the feature or not

$user->getFeature($featureSlug); // Return data for a feature

$user->getRemainingDays(); // Calculate the remaining days of the active plan

$user->getPlanData(); // Return plan details

$user->getChargeData(); // Return active and recent cancelled charge

$user->setDefaultPlan($plan_id); // Set default plan_id( plan_id Optional)
```

### Extras

[](#extras)

Set Shopify API version to 2022-04.

#### Store plan's total trial Days in shop table (Optional)

[](#store-plans-total-trial-days-in-shop-table-optional)

Set total\_trial\_days field name in config/app-manager.php

```
'total_trial_days' => env('TOTAL_TRIAL_DAYS', 'toal_trial_days'),
```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Shailesh Desai](https://github.com/shailesh-hulkapps)
- [Lamija Dzambo Bajric](https://github.com/lamijadzambo)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance89

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity69

Established project with proven stability

 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 ~23 days

Recently: every ~82 days

Total

64

Last Release

61d ago

Major Versions

1.0.0 → 2.0.02022-05-26

2.5.8 → 3.0.02025-09-30

### Community

Maintainers

![](https://www.gravatar.com/avatar/50a642dc32d5027ab857eb51c9eb17a0dc12222d48b9de35d7dc4458229d06e8?d=identicon)[dreamteam-hulkapps](/maintainers/dreamteam-hulkapps)

![](https://www.gravatar.com/avatar/3a42516c83cd2f32b12e19a514935ab635affd70066b74a8786747b0c92dab2a?d=identicon)[shailesh-hulkapps](/maintainers/shailesh-hulkapps)

---

Top Contributors

[![chirag-hulkapps](https://avatars.githubusercontent.com/u/90819534?v=4)](https://github.com/chirag-hulkapps "chirag-hulkapps (125 commits)")[![shailesh-hulkapps](https://avatars.githubusercontent.com/u/71643987?v=4)](https://github.com/shailesh-hulkapps "shailesh-hulkapps (92 commits)")[![lamijadzambo](https://avatars.githubusercontent.com/u/46093043?v=4)](https://github.com/lamijadzambo "lamijadzambo (90 commits)")[![dvmunjapara](https://avatars.githubusercontent.com/u/7050851?v=4)](https://github.com/dvmunjapara "dvmunjapara (59 commits)")[![dv-hulkapps](https://avatars.githubusercontent.com/u/70259345?v=4)](https://github.com/dv-hulkapps "dv-hulkapps (30 commits)")[![shaileshdesai](https://avatars.githubusercontent.com/u/16317185?v=4)](https://github.com/shaileshdesai "shaileshdesai (4 commits)")[![chirag-shopcircle](https://avatars.githubusercontent.com/u/138557422?v=4)](https://github.com/chirag-shopcircle "chirag-shopcircle (3 commits)")

---

Tags

hulkappsappmanager

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hulkapps-appmanager/health.svg)

```
[![Health](https://phpackages.com/badges/hulkapps-appmanager/health.svg)](https://phpackages.com/packages/hulkapps-appmanager)
```

###  Alternatives

[s-ichikawa/laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

4139.3M1](/packages/s-ichikawa-laravel-sendgrid-driver)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[laravel-notification-channels/microsoft-teams

A Laravel Notification Channel for Microsoft Teams

1603.0M7](/packages/laravel-notification-channels-microsoft-teams)[spatie/laravel-export

Create a static site bundle from a Laravel app

646127.9k5](/packages/spatie-laravel-export)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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