v1.3.0 — Usage-based billing

Usage-based billing

• Track workspace meters (api_calls, team_seats) per calendar month
• GET /api/workspaces/{id}/usage
• Subscription API includes usage summary
• Billing page usage section
• Optional Stripe sync via USAGE_SYNC_TO_STRIPE
• api-operator adapter stub in integrations/api-operator/

See CHANGELOG.md for full details.

v1.2.3

Summary

• Fixes GitHub Actions fresh-install smoke test for Filament /admin/tenants
• Uses isolated check-tenants-page.php subprocess instead of in-process kernel (v1.2.2 reorder alone was insufficient on CI)

Note

• v1.2.2 tag remains; use v1.2.3 for green CI.

v1.2.2

Summary

• Fixes GitHub Actions fresh-install smoke test (Filament admin path)
• Runs /admin/tenants check before API suspend mutations so CI matches a real first admin visit

v1.2.1

Added

• API rate limiting on token auth
• Sanctum token abilities
• GET /api/workspaces/{id}/subscription
• POST /api/team/invitations
• Workspace suspend/unsuspend from Filament

Fixed

• PHP intl extension in Docker (Filament /admin/tenants)
• Workspace URLs with correct Docker port (:8080)
• Refreshed README screenshots and demo GIF

See CHANGELOG.md for full details.

v1.2.0 — OAuth, Sanctum API & SaaS Analytics

What's new

OAuth (Google & GitHub)

• Social login on the central app via Laravel Socialite
• Optional — enable with GOOGLE_* / GITHUB_* keys in .env
• 8 PHPUnit tests with mocked providers

Sanctum API

• Central API (/api/auth/token, /api/workspaces)
• Tenant API (/api/auth/token, /api/team) per workspace subdomain
• See docs/api.md

SaaS Analytics (Filament)

• Platform metrics widgets: workspaces, subscriptions, users
• 6-month workspace growth chart

Quality & DX

• 35 PHPUnit tests + 36 smoke checks (scripts/system-test.php)
• CI: fresh migrate:fresh --seed + HTTP smoke test on every push
• migrate:fresh --seed fix (orphan tenant DB cleanup)
• Docker: ports 80 and 8080, OPcache tuning for Windows
• New demo GIF + refreshed screenshots in README

Upgrade

\\�ash
git pull
composer install
php artisan migrate
php artisan tenants:migrate
npm run build
\\

Demo credentials

Context	URL	Email	Password
Admin	/admin	admin@laravel-tenant-kit.test	password
Demo workspace	demo subdomain	demo@demo.test	password

v1.1.0 - Docker, PostgreSQL and Redis

Laravel Tenant Kit v1.1.0

Infrastructure release — Docker, PostgreSQL, and Redis.

Added

• Docker Compose — PHP 8.4-FPM, Nginx, MySQL 8.4, Redis 7
• Setup scripts: scripts/docker-setup.ps1 (Windows) and scripts/docker-setup.sh (macOS/Linux)
• Pre-configured .env.docker for container networking
• docs/docker.md — full Docker guide

PostgreSQL

• Documented pgsql support (Stancl PostgreSQLDatabaseManager was already configured)
• Optional postgres service via docker compose --profile pgsql up
• .env.pgsql.example for quick switching

Redis

• TENANCY_USE_REDIS_BOOTSTRAPPER env flag enables per-tenant Redis key isolation
• .env.docker enables Redis for cache, queue, and sessions out of the box
• Documented production Redis setup in README

Quick start (Docker)

.\scripts\docker-setup.ps1
# Open http://laravel-tenant-kit.test:8080

v1.0.0 - Laravel Tenant Kit

Laravel Tenant Kit v1.0.0

First stable release of the production-ready multi-tenant SaaS starter for Laravel.

Features

• Multi-tenancy — isolated MySQL database per workspace, subdomain and custom domain routing (Stancl Tenancy)
• Authentication — Laravel Breeze on central app and inside each tenant workspace
• Teams and roles — Spatie Permission (owner / admin / member) with email invitations
• Stripe billing — Laravel Cashier subscriptions per workspace
• Filament admin — manage workspaces, domains, and platform stats at /admin
• Localization — English + Arabic with RTL support, extensible via config/locales.php
• CLI — php artisan tenant:provision to create fully migrated workspaces
• CI — GitHub Actions test workflow
• Docs — comprehensive README + screenshots in docs/screenshots/

Requirements

PHP 8.4+, Laravel 13, MySQL 8+, Node.js 20+

Quick start

git clone https://github.com/mohammedelkarsh/laravel-tenant-kit.git
cd laravel-tenant-kit
composer install && npm install
cp .env.example .env && php artisan key:generate
php artisan migrate && php artisan db:seed
npm run build

Demo credentials (after db:seed)

Context	URL	Email	Password
Admin	/admin	admin@laravel-tenant-kit.test	password
Demo workspace	http://demo.laravel-tenant-kit.test	demo@demo.test	password

Changelog

• 77ed778 — Initial production-ready multi-tenant SaaS starter kit
• f0815da — CI fix (Vite build + central domain in tests)
• 96a9ae4 — Screenshots and README gallery