BillingPlans
Plans
Orbits has two plans per team. Free hosts unlimited projects. Pro, at $5 a month paid in Naira, adds server functions, Analytics and Speed Insights. What each includes, what happens when Pro ends, and the plan_required error.
Free and Pro
A plan belongs to a team, not a person: every project in the team gets what the team's plan includes. Owners manage the plan; everyone in the team can see which plan it's on.
| Free | Pro | |
|---|---|---|
| Price | Nothing | $5 a month, charged in Naira |
| Projects | Unlimited | Unlimited |
| Static sites, Node apps, workers | Yes | Yes |
| Next.js, SvelteKit, Nuxt, Remix and other server-rendered apps | Yes, run as apps | Yes, as server functions |
The function workload (server functions) | No | Yes |
| Analytics | No | Yes |
| Speed Insights | No | Yes |
| Sandboxes | No | Yes, once they're available |
| Previews, custom domains, Orbits DNS, logs, observability, alerts, flags, workflows | Yes | Yes |
Pro is priced in US dollars and charged in Naira through Flutterwave. See paying for Pro.
Server-rendered apps on Free
On Free, a project whose framework would run as a server function (Next.js, SvelteKit, Nuxt, Remix and the like) is created as an ordinary app instead. It builds and serves the same way. Asking for the function workload outright on Free is refused with plan_required.
Previews on Pro
On Pro, a project serves at most 3 ready previews at a time, the three newest; when a fourth is ready, the oldest stops being served. Redeploying its branch builds it again. Production is never affected or counted. See previews.
Sandboxes
Sandboxes, on-demand development machines for a project, are part of Pro but aren't available yet.
Upgrading
An owner upgrades the team from its billing page. Pro starts as soon as the payment is confirmed, and every Pro feature is available at once. See paying for Pro.
When a feature needs Pro: 402 plan_required
Anything Free doesn't include is refused with 402 Payment Required, in the web app as an upgrade prompt and in the API as:
{
"title": "Payment Required",
"status": 402,
"detail": "Analytics are on the Pro plan.",
"code": "plan_required",
"required_plan": "pro",
"feature": "analytics",
"request_id": "…"
}feature names what's missing: analytics, speed_insights, functions or sandboxes. You get it for:
- turning Analytics or Speed Insights on (turning them off always works);
- creating a project with the
functionworkload, or deploying, redeploying or promoting a project that runs as one; - creating or starting a sandbox.
Reading a Pro feature's page on Free shows it as locked rather than failing. See API › Errors.
When Pro ends
Pro ends when an owner cancels it (at the end of the month already paid) or when a renewal isn't paid by the end of the 7-day grace period. The team goes back to Free, and Orbits stops new use but keeps your data:
| What happens | |
|---|---|
| Analytics and Speed Insights | Collection stops. What was collected, and the switches, are kept but hidden |
| Projects that run as server functions | Keep running and serving. They can't be deployed, redeployed or promoted on Free; a build started by a push fails with "Pro plan required" |
| Sandboxes | Stop, and can't be started |
| Everything else | Unchanged |
Nothing is deleted. Pay for Pro again and everything comes back at once: Analytics and Speed Insights start collecting again, and server-function projects can deploy.
Deleting a team on Pro
Deleting a team ends its Pro plan straight away, with no refund. Nothing is charged again and the saved card is forgotten. Paid invoices are kept as the record of the payment. See deleting a team.
From the API
GET /v1/plans lists the plans and their prices, with no sign-in needed. Each plan has its id (free or pro), name, usd_cents (500 for Pro), ngn and features (unlimited_projects, functions, sandboxes, analytics, speed_insights). The answer's rate is the dollar-to-Naira rate in use.
ngn is Pro's Naira price at today's rate, rounded up to a whole ₦100; it's null while Pro can't be bought. GET /v1/teams/{team}/billing says which plan the team is on and entitlements, what it may use right now. See API › Billing.