Quick Start
Get deployed in minutes, not hours. No install required.
Deploy Your App
Open a terminal in your project directory and run:
Just tell Claude what you want:
Deploy this app to TelbaseClaude runs telbase deploy for you, reads the structured response, and reports the live URL. If the build fails, Claude reads the error suggestions and fixes the code automatically.
npx telbase works immediately with Node.js. No signup required for your first deploy — you'll be prompted to authenticate on the first run. For frequent use, install globally: npm install -g telbase.Login
If this is your first deploy, the CLI opens a browser for device authentication:
telbase loginConfirm the code shown in your terminal. Once authenticated, you won't need to log in again on this machine.
Your App is Live
Telbase auto-detects your framework (Next.js, Vite, FastAPI, Django, Express, Go, static HTML, and more), selects the right infrastructure, and deploys. Your app goes live at a unique subdomain:
{
"success": true,
"data": {
"status": "live",
"url": "https://my-app.telbase.ai",
"detection": {
"framework": "nextjs",
"ormType": "prisma",
"databaseProvider": "neon"
}
}
}Add a Database
If your project uses Prisma or Drizzle, the database is provisioned automatically on first deploy. No extra steps needed.
# Check database status after deploy
telbase db statusSQLite projects get a Turso database. PostgreSQL projects get Neon. You don't need to choose — it's selected based on your schema.
# Pull the connection string for local development
telbase env pullShare With Your Team
Restrict access to your team:
# Protect with email domain (Google Workspace, Microsoft Entra, etc.)
telbase access enable google
telbase access domain add yourcompany.com
# Or protect with individual emails
telbase access allow [email protected]Add a custom domain:
telbase domain add app.yourcompany.comRedeploy
Made changes? Redeploy with one command:
telbase deployOr connect GitHub for automatic deploys on every push:
telbase github connectSet Up Your AI Agent
Add TELBASE.md to your repo so any AI coding agent can deploy to Telbase automatically — no internet fetch needed.
npx telbase initOr download TELBASE.md manually and add it to your repo root. Works with Claude Code, Cursor, Copilot, Windsurf, and more.
Next Steps
- AI Agent Setup — download TELBASE.md for any AI coding agent
- Databases — migrations, backups, pgvector, and more
- Claude Code — MCP tools, /deploy command, AI feedback loop
- CLI Reference — every command, flag, and example
- Guides & Tutorials — the edit-deploy-test loop, writing great prompts, and more