Account

Plans & Billing

How OrbitNest plans work, which features the Pro tier unlocks, and how to manage your subscription through the billing portal.

OrbitNest has a free tier to build and prototype on, and a Pro tier that unlocks the production-grade infrastructure features. Every new account starts with a 14-day Pro free trial — no charge on day one. Subscriptions are handled through Stripe, so billing, receipts, and the customer portal are managed for you.

What the Pro tier unlocks

The free tier covers the core: projects, the Postgres database, the SQL editor, authentication, and API keys. The following features are gated to Pro:

Storage — buckets and file uploads.
Edge Functions — serverless functions.
Background Jobs — scheduled cron jobs.
Realtime — live database change streaming.

Enforced at the API

Plan gating is enforced server-side on the protected endpoints, not just hidden in the UI. Calling a Pro-only endpoint on the free tier returns a clear upgrade-required error.

Pricing & free trial

Two paid plans, billed monthly: Starter is $6.99/month (up to 3 projects) and Pro is $14.99/month (unlimited projects and every platform feature). Every new paid subscription starts with a 14-day free trial — you get the full feature set immediately, with no charge on day one.

How the trial ends

Stripe collects a payment method at checkout but does not charge it during the trial. When the 14 days are up, the first invoice is billed automatically. If no valid payment method is on file by then, the subscription is cancelled cleanly and the account drops to the free tier.

Check subscription status

Read your current plan and subscription state at any time:

bash

curl https://studio.orbitnest.io/api/subscription/status \
  -H "Authorization: Bearer $TOKEN"

Manage billing

The portal endpoint returns a link to the Stripe Customer Portal where you can update payment methods, view invoices, and change or cancel your plan:

bash

curl https://studio.orbitnest.io/api/subscription/portal \
  -H "Authorization: Bearer $TOKEN"

Sync after a change

After returning from Stripe Checkout, you can force a sync so the Studio reflects the new entitlement immediately rather than waiting for the next webhook:

bash

curl -X POST https://studio.orbitnest.io/api/subscription/sync \
  -H "Authorization: Bearer $TOKEN"

OrbitNest also receives Stripe webhooks, so subscription changes (renewals, cancellations, billing failures) propagate automatically.

Downgrading

If you downgrade, Pro-only resources keep their data but become read-only or paused until you upgrade again — nothing is deleted by the plan change itself.