You ask your coding agent to deploy. Here is everything that happens between that request and your app going live — reading the project, choosing the provider, registering, migrating, deploying, verifying. Every step, explained.
Following the Telbase skills, your coding agent reads your project files: framework and runtime, database ORM and SQL dialect, the env vars it needs, and any background work. Your code is your configuration — nothing to write, nothing to declare.
📄package.json
📄next.config.js
📁prisma/
📄schema.prisma
📁src/
📁app/
📄page.tsx
📄layout.tsx
📁api/
📄route.ts
📄.env.example
Framework
from package.json
Next.js 14 (App Router)
ORM
from prisma/schema.prisma
Prisma
Database Dialect
from prisma/schema.prisma
PostgreSQL
Environment Requirements
from .env.example
DATABASE_URL (required)
Background Work
from requirements.txt + worker_main.py
In-process scheduler (APScheduler)
The agent reads your configuration files the same way a developer would — package.json for framework and dependencies, schema files for ORM and dialect, directory structure for service boundaries. No Telbase configuration file. Your existing code is the only input.
Step 2
Your agent picks the right provider for each part.
The skills give the agent the choice for each kind of app: web frontends and request/response APIs on Vercel, containers and every other runtime on Google Cloud Run, and a PostgreSQL or SQLite database when the app needs one.
Your Code
Next.js + Prisma + PostgreSQL
The Telbase skills
Framework, runtime and database
</>
Vercel
Global CDN and server-side rendering for web frontends, and request/response Node APIs.
Next.js, Remix, SvelteKit, Astro, Vite, Express
⚙
Google Cloud Run
Auto-scaling containers for every other runtime, and Node servers that must keep running.
Django, FastAPI, Go, Java, Docker
◫
Managed Database
PostgreSQL that scales to zero, or hosted SQLite. Created with the app.
PostgreSQL, SQLite
Telbase deploys to enterprise-grade cloud providers including Google Cloud, Vercel, and Neon. You don’t need accounts with any of them — Telbase manages the infrastructure on your behalf.
Step 3
Telbase creates what the app needs.
The agent registers the app with telbase apps create. Telbase reserves its URL, creates its database and serves it over HTTPS; the agent sets its variables.
✓
App registered
telbase apps create reserves your-app.telbase.ai and answers the exact deploy command for the app.
✓
Database instance
A PostgreSQL or SQLite database is created for the app. Isolated per app; PostgreSQL scales to zero when idle.
✓
Connection strings set
The agent sets DATABASE_URL on the provider from a command, never through a file. No copy-pasting from dashboards.
✓
SSL certificates
HTTPS is configured automatically. Your app is served over TLS from the first request.
✓
A Telbase URL per app
Each app is served at its own URL. Several services are several apps — web.telbase.ai for the frontend, api.telbase.ai for the backend.
✓
Variables between services
The agent gives the frontend the API’s Telbase URL and sets the API’s CORS origins to the frontend’s.
Step 4
Your agent runs the migrations.
The agent runs your app's own migration command with telbase db run, which sets DATABASE_URL for that one command. No SSH sessions. No connection strings in files.
$ telbase db run my-app -- npx prisma migrate deploy→ ORM: Prisma(from prisma/schema.prisma)→ Running against: DATABASE_URL(managed PostgreSQL, direct URL)→ Migrations applied: 3 pending → done
ORM
Migration Command
Dialects
Prisma
npx prisma migrate deploy
PostgreSQL, SQLite
Drizzle
npx drizzle-kit push
PostgreSQL, SQLite
Django ORM
python manage.py migrate
PostgreSQL
Alembic
alembic upgrade head
PostgreSQL
GORM / Ent
Auto-migrate at runtime
PostgreSQL
Migrations are the step most platforms skip. They expect you to SSH in or run a separate command. The Telbase skills make them part of the deploy — because a deploy is new code plus the schema it requires.
Steps 5 & 6
Build, deploy, verify.
The agent deploys with the provider's CLI through Telbase, then checks the app at its Telbase URL.
Build
Code is built at the provider.
Vercel builds web apps. Cloud Run builds containers from your Dockerfile, or without one for Python, Go and Node.
20–40s
Deploy
The new version serves at the Telbase URL.
The new deployment or revision serves at the app’s Telbase URL. Rollback to an earlier build is available if anything goes wrong.
10–20s
Verify
Your agent checks it’s live.
The agent fetches the home page and a route that reads the database at the Telbase URL. If something fails, it reads the logs, fixes the code and redeploys.
5–10s
When Things Break
Failures come with what to do next.
When a build or the app fails, the agent reads the build log and the app's logs, fixes the code, and redeploys. When Telbase refuses a command, the answer names the reason and what to run instead.
Other Platforms
Error: connect ECONNREFUSED 127.0.0.1:5432
at TCPConnectWrap.afterConnect
at Object.onceWrapper (events.js:520:26)
at TCPConnectWrap.emit (events.js:400:28)
Telbase
{
"code": "NAME_TAKEN",
"message": "my-app is already taken",
"fix": [
"Pick another name; the Telbase URL
<name>.telbase.ai is global."
]
}
Compatibility
Frameworks, ORMs, and databases.
What Telbase hosts, and the ORMs your agent migrates with.
Frameworks
Next.jsApp Router & Pages
Remix
SvelteKit
Astro
Angular
ViteReact, Vue, Svelte, Solid
Nuxt
Express
NestJS
FastAPI
Django
Flask
Gonet/http, Gin, Echo, Fiber
Node.jsServers that keep running
DockerAny language
Static HTML
ORMs
PrismaPostgreSQL, SQLite
DrizzlePostgreSQL, SQLite
SQLAlchemyPostgreSQL
Django ORMPostgreSQL
GORMPostgreSQL
EntPostgreSQL
Databases
PostgreSQLManaged, serverless
SQLiteManaged, over libSQL
Open Standard
Works from any AI coding tool.
The Telbase skills install for Claude Code, Cursor, Windsurf and the agents that read AGENTS.md. Claude Code can also use the Telbase MCP server — the Model Context Protocol — with 45 tools, all returning structured JSON.
Claude CodeCursorWindsurfCodex (AGENTS.md)
Session & Apps
5 tools
get_session, register_app, +3 more
Deploys & Logs
5 tools
get_deploy_status, get_deploy_logs, +3 more
Project Management
4 tools
list_projects, get_project, +2 more
Service Control
5 tools
check_app_health, restart_service, +3 more
Rollback
2 tools
rollback_deploy, list_rollback_targets
Environment Variables
3 tools
set_env_vars, list_env_vars, +1 more
Database
2 tools
get_database_info, enable_database_extension
Custom Domains
4 tools
add_custom_domain, verify_custom_domain, +2 more
Scheduled Jobs
5 tools
get_job_executions, run_scheduled_job, +3 more
Storage
2 tools
get_storage_info, get_storage_credentials
GitHub
3 tools
get_github_status, connect_github, +1 more
Team & Organization
4 tools
list_team, invite_member, +2 more
Account
1 tool
get_account_status
// Every response is structured JSON// Your AI agent parses it and acts
{
"name": "my-app",
"telbaseUrl": "https://my-app.telbase.ai",
"deployCommand": "telbase vercel deploy --prod --yes"
}
Now you know how it works. Try it.
Your agent deploys. Enterprise infrastructure. Free tier. No credit card.