README

A feature-based SaaS subscription engine for Laravel.

Laravel Subscription Core provides a flexible, usage-aware subscription system designed for modern multi-tenant SaaS applications. It enables you to define plans, attach feature limits, track usage, and manage subscription lifecycle without locking you into any specific billing provider.

🚀 Features

Feature-based plan limits
Usage tracking & metering
Trial support
Grace period support
Plan switching
Subscription renewal & cancellation
Resettable usage windows (daily / monthly)
Multi-tenant ready
Billing provider independent (Stripe, Razorpay, etc.)

📦 Installation

Install via Composer:

composer require bytebeez/laravel-subscription-core

Laravel will automatically discover the package.

⚙️ Publish Assets

Publish configuration file:

php artisan vendor:publish --tag=subscription-config

Publish migrations:

php artisan vendor:publish --tag=subscription-migrations

Run migrations:

php artisan migrate

🧠 Core Concepts

Plans

Define pricing structure and billing cycle.

Features

Attach limits or toggles to plans such as:

Number of users
Appointments
API usage
Storage
Enabled modules

Subscriptions

Assigned to an organization and linked to a plan.

Usage Tracking

Automatically records consumption of feature limits.

🏗️ Example Usage

Check if an organization can use a feature:

app('subscription-core')->canUse($organization, 'appointments');

Record usage:

app('subscription-core')->record($organization, 'appointments');

🔌 Billing Ready

This package does NOT enforce any payment gateway.

You can integrate:

Stripe
Razorpay
PayPal
Offline billing

without modifying core subscription logic.

🏢 Multi-Tenant Support

The package is designed to work with organization-based SaaS systems.

You can configure your tenant model in:

config/subscription.php

🧩 Use Cases

SaaS ERP systems
Healthcare platforms
Queue management apps
AI tools
EdTech platforms
Marketplaces

🛠️ Compatibility

Supports:

Laravel 10
Laravel 11
Laravel 12

📜 License

MIT License

bytebeez / laravel-subscription-core

Maintainers

Package info

Statistics

Security