cboxdk / laravel-id-billing
Billing console for Cbox ID — plan, invoices and usage-vs-limit, read from a billing service through cboxdk/laravel-billing-client and plugged into the console through laravel-console-kit. Optional: install it only where you actually bill.
Maintainers
Requires
- php: ^8.4
- cboxdk/laravel-billing-client: ^0.3
- cboxdk/laravel-console-kit: ^0.2
- illuminate/contracts: ^12.0 || ^13.0
- illuminate/support: ^12.0 || ^13.0
- livewire/volt: ^1.6.0 || ^2.0
Requires (Dev)
- larastan/larastan: ^3.0
- laravel/pint: ^1.18
- orchestra/testbench: ^10.0 || ^11.0
- pestphp/pest: ^3.5 || ^4.0
README
cboxdk/laravel-id-billing — the billing console for Cbox ID, as a drop-in
package. Data and UI in one place: a Billing area (plan, invoices,
usage-vs-limit), a dashboard current-plan card, and gates — all plugged into
laravel-console-kit and gated on the
billing feature, which is active only when the billing client
is wired.
Optional by design. Cbox ID is free to self-host with no limits and no licence
key, and it never depends on this package. Install it only where you actually bill
someone — then Billing lights up and entitlements can be metered
(CBOX_ID_ENTITLEMENTS=metered). Leave it out and nothing about the application
changes.
What it adds
- Nav — a
Billingarea with Overview and Invoices, gated onbilling. - Overview — current plan + status, usage-vs-limit meters (from
UsageSummary), and a Manage billing button that hands off to the billing portal. - Invoices — the org's invoice history.
- Dashboard card — the current plan, on the overview page.
- Route gate —
console.feature:billing, so the routes 404 without billing.
All data comes from the billing client's BillingManagement; this package renders it
in the host console's shell.
Install (SaaS)
composer require cboxdk/laravel-id-billing
Requires the billing client configured (so BillingManagement is bound) and a host
console that has adopted laravel-console-kit.
License
MIT. See LICENSE.