How danidoble/maestro works
Maestro is a multi-tenant SaaS starter kit: a central application manages customer workspaces, domains, plans, and billing, while domain-resolved tenant applications provide isolated organization features. Users enter through central management or tenant-domain authentication, then interact with workspace administration, access controls, and notifications; subscribed customers also pass through plan checkout and ongoing billing enforcement. The README documents tenant database provisioning and additional Stripe and authentication capabilities. Some subsystems are represented by their exact enclosing directories because their implementation excerpts were not provided.
Main entry points: central Central dashboard · TenantsController.php Tenant administration · BillingController.php Checkout and billing · DatabaseSeeder.php Tenant databases
Components 21
Central management
- Central dashboard
resources/js/pages/central - Tenant administration
app/Http/Controllers/Web/Central/TenantsController.php - Domain management
app/Http/Controllers/Web/Central - Announcements
app/Http/Controllers/Web/Central/TenantAnnouncementController.php
Tenant lifecycle
- Tenant and domains
app/Models/Central/Tenant.php - Tenant provisioning
app/Providers/TenancyServiceProvider.php - Tenant databases
database/seeders/Tenant/DatabaseSeeder.php
Plans and billing
- Plan management
app/Http/Controllers/Web/Central/PlanController.php - Checkout and billing
app/Http/Controllers/Web/Central/BillingController.php - Subscription sync
app/Listeners/HandleStripeWebhook.php - Plan entitlements
app/Billing/EntitlementService.php - Billing access
app/Billing/BillingAccessManager.php
Shared user features
- Authentication
app/Providers/FortifyServiceProvider.php - Users and roles
app/Http/Controllers/Web/Universal/UserController.php - Roles and permissions
app/Models/Universal/Role.php - Notification inbox
app/Http/Controllers/Web/Universal/NotificationController.php
Frontend and tenancy
- Domain tenancy routing
bootstrap/app.php - Inertia frontend
resources/js/app.tsx
Other components
- Central user
- Tenant user
- Stripe
Connections 22
- Central user → Central dashboard: uses
README.md - Central dashboard → Tenant administration: manages tenants
README.md - Tenant administration → Tenant and domains: creates tenant
app/Http/Controllers/Web/Central/TenantsController.php - Tenant administration → Domain management: registers domain
app/Http/Controllers/Web/Central/TenantsController.php - Tenant administration → Tenant provisioning: triggers provisioning
README.md - Tenant provisioning → Tenant databases: creates and seeds
README.md - Central dashboard → Announcements: manages announcements
README.md - Central dashboard → Plan management: manages plans
README.md - Central user → Checkout and billing: starts checkout
README.md - Checkout and billing → Stripe: opens checkout
README.md - Stripe → Subscription sync: sends events
README.md - Subscription sync → Billing access: synchronizes access
app/Listeners/HandleStripeWebhook.php - Checkout and billing → Plan entitlements: checks entitlements
app/Http/Controllers/Web/Central/BillingController.php - Tenant and domains → Billing access: tracks access state
app/Billing/BillingAccessManager.php - Tenant user → Domain tenancy routing: opens tenant domain
README.md - Domain tenancy routing → Tenant databases: selects tenant context
README.md - Tenant user → Authentication: authenticates
README.md - Tenant user → Users and roles: manages users
README.md - Users and roles → Roles and permissions: assigns roles
app/Http/Controllers/Web/Universal/UserController.php - Tenant user → Notification inbox: views notifications
README.md - Notification inbox → Tenant databases: reads tenant announcements
app/Http/Controllers/Web/Universal/NotificationController.php - Central dashboard → Inertia frontend: renders interface
README.md