Plans & Usage
How Telbase counts resources against your plan — and what happens when you need more.
Quick Reference
| Resource | What It Is | Scope | Overages |
|---|---|---|---|
| Websites | Static sites (Vite, Astro, HTML) | Per org | Unlimited on paid |
| Apps | Full-stack projects (Next.js, Django, etc.) | Per org | 20 credits/mo ($2) |
| Deploys | Every deploy attempt (success or failure) | Monthly, org | 1 credit ($0.10) |
| Databases | SQLite or PostgreSQL, counted equally | Per org | 15 credits/mo ($1.50) |
| Custom Domains | Non-*.telbase.ai domains (Free: 0, Starter: 1, Builder: 5, Pro: unlimited) | Per org | Not credit-expandable |
| Scheduled Jobs | Cron jobs via Cloud Scheduler | Per org | 20 credits/mo ($2) |
| File Storage | R2 object storage (Free: 0, Starter: 1 GB, Builder: 5 GB, Pro: 25 GB) | Per project | Included in plan |
| Always On | Keep one GCP instance warm (eliminates cold starts) | Per service | 100 credits/mo ($10), Pro includes 1 |
| Team Members | Collaborators in your organization (Free: 1, Paid: unlimited) | Per org | — |
| Credits | $1 = 10 credits, 12-month expiry | Per org | — |
Websites
A website is any project built with a static framework: Vite, Astro, or plain HTML (no package.json).
- Classification is framework-based — a Vite + React project is a website even if it connects to an external database
- Free plan: 10 websites. Paid plans: unlimited
- See Supported Frameworks for the full framework list
Apps
An app is any project using a framework other than Vite, Astro, or static HTML. This includes:
- Node.js — Next.js, Remix, SvelteKit, Angular, Express, NestJS
- Python — Django, FastAPI, Flask
- Go — any project with
go.mod - Docker — any Dockerfile (Starter and above)
Plan limits:
- Free: 1 sandbox app
- Starter ($5/mo): 2 apps
- Builder ($19/mo): 5 apps
- Pro ($79/mo): 15 apps
- Beyond your plan limit: 20 credits/month ($2) per extra app
Deploys
A deploy is any deploy attempt — whether it succeeds, fails, or is cancelled. All types count:
- CLI deploys (
telbase deploy) - GitHub push deploys
- Rollbacks
Multi-service projects: each service counts as 1 deploy. A 3-service monorepo uses 3 deploys per push.
Deploy limits reset on the 1st of each month (UTC):
- Free: 5/mo
- Starter: 30/mo
- Builder: 150/mo
- Pro: 500/mo
- Beyond your plan limit: 1 credit ($0.10) per extra deploy
Databases
SQLite and PostgreSQL databases count equally — 1 database = 1 against your limit regardless of type. The count is org-wide across all projects.
- Free: 1 sandbox database
- Starter: 2 databases
- Builder: 5 databases
- Pro: 15 databases
- Beyond your plan limit: 15 credits/month ($1.50) per extra database
See Databases for provisioning, migrations, backups, and extensions.
Multi-Service Projects
When you deploy a monorepo with multiple services, each service counts as 1 deploy against your monthly limit.
For project classification, “worst wins” — if any service uses a full-stack framework, the whole project counts as 1 app:
- Vite frontend + FastAPI backend = 1 app (FastAPI is full-stack)
- Vite frontend + Astro docs site = 1 website (all services are static)
See Full-Stack & Monorepos for deploy details, routing, and environment variables.
Scheduled Jobs
Scheduled jobs run on a cron schedule via GCP Cloud Scheduler. Each active job uses one slot from your plan.
| Plan | Included Slots | Max Timeout |
|---|---|---|
| Free | 0 (not available) | — |
| Starter | 1 | 5 minutes |
| Builder | 3 | 10 minutes |
| Pro | 10 | 30 minutes |
Extra slots cost 20 credits/month ($2/mo). Execution compute is consumption-based: 1 credit = 25 compute-minutes.
Credits & Overages
Credits let you go beyond your plan limits without upgrading. $1 = 10 credits, $5 minimum purchase, 12-month expiry.
| Overage Type | Cost | Price |
|---|---|---|
| Extra deploy | 1 credit | $0.10 |
| Extra app | 20 credits/mo | $2/mo |
| Extra database | 15 credits/mo | $1.50/mo |
- Auto-refill: automatically buy credits when your balance reaches 0. Configurable monthly caps ($10, $20, or $40/mo)
- Grace period: when credits run out, extra resources get a 14-day grace period, then are suspended (not deleted). Your data is always preserved
- Plan resources are never affected by your credit balance — only extra resources beyond your plan limit
Organization Limits
All limits — apps, websites, deploys, databases, custom domains, and credits — are per organization, not per user or per project.
Next Steps
- Pricing — compare plans and see growth scenarios
- Supported Frameworks — full framework list and classification
- Databases — provisioning, migrations, backups
- Full-Stack & Monorepos — multi-service deploy details