masterix21

masterix21 / laravel-entitlements

Public

Simple and flexible entitlement management for Laravel applications, with support for plans, features, limits, and usage tracking.

46
1
89% credibility
Found May 28, 2026 at 46 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
PHP
AI Summary

Laravel Entitlements is a subscription and usage management system for Laravel applications. It helps developers build SaaS products by handling the complex logic of subscription plans, customer licenses, and resource consumption tracking. Users can create different plan types (like monthly or yearly), define what resources each plan includes (such as device slots, API tokens, or user seats), and the system automatically tracks how customers use their entitlements. The package supports two tracking methods: slot-based for things that are held individually, and pool-based for shared resources that drain as they're used. It also handles plan transitions when customers upgrade or downgrade, with options to apply changes immediately or at the end of their billing period. An optional admin panel is included for managing plans and viewing customer subscriptions.

How It Works

1
🔍 You discover a subscription management system

You're building a SaaS app and need to track customer subscriptions, usage limits, and plan changes without reinventing the wheel.

2
✨ You define your entitlement types

You create a simple list of what you want to track—like devices, AI tokens, or user seats—and choose how each one should be managed.

3
📋 You create your subscription plans

You set up plans like 'Pro Monthly' or 'Business Yearly', deciding how many of each entitlement type each plan includes.

4
🎁 A customer subscribes to a plan

When someone signs up, you assign them a plan and the system automatically creates their licenses with the correct limits.

5
Usage is tracked automatically
🔢
Slot-based tracking

For things like devices or seats, each one is counted individually until released.

💧
Pool-based tracking

For things like API calls or tokens, a shared pool drains down as everyone uses it.

6
🔄 Customers can change plans

When someone wants to upgrade or downgrade, you can make the change immediately or schedule it for their next billing date.

🎉 Everything runs smoothly

Your subscription business is fully operational with automatic tracking, plan changes, and usage monitoring—all handled for you.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 46 to 46 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is laravel-entitlements?

Laravel Entitlements is a PHP package that handles the messy subscription and entitlement logic every SaaS reinvents. It gives you plans with features and limits, then lets you issue licenses to any model in your system—whether that's a user, team, workspace, or tenant. Usage tracking comes in two flavors: slot-based (one allocation per subject, like device seats) or pool-based (drainable counters like API tokens). The package also handles plan upgrades, downgrades, and cancellations with proper audit trails, plus an optional Filament admin panel for managing everything from the browser.

Why is it gaining traction?

The polymorphic design is the hook—slap a trait on any model and it can hold licenses. Two consumption strategies cover most real-world scenarios out of the box, and you can plug in custom ones if needed. Plan transitions support immediate switches, end-of-billing-cycle changes, or scheduled upgrades, with validation that prevents subscribers from losing access to features they're actively using. The two-phase release flow (request then confirm) handles hardware deactivation cleanly. Built-in domain events let you wire this into billing webhooks, notifications, or external systems without hacking the core.

Who should use this?

Laravel developers building multi-tenant SaaS with subscription tiers, seat limits, or metered resources. Teams that need device management, token pools, or add-on packs where customers can stack plans. Projects that want a clean separation between plan logic and business code without rolling their own entitlement engine. If you need an admin UI, Filament v5 is included.

Verdict

This is a well-architected package solving a genuine problem, but the 46-star count signals early-stage software. Documentation is solid and the codebase passes static analysis, but production readiness depends on your risk tolerance. The 0.9% credibility score reflects that maturity. Worth evaluating for greenfield Laravel SaaS projects, but audit the test suite closely before betting on it for critical billing flows.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.