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:

markdown
Deploy this app to Telbase

Claude 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.

Zero install
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:

bash
telbase login

Confirm 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:

Deploy response
{
  "success": true,
  "data": {
    "status": "live",
    "url": "https://my-app.telbase.ai",
    "detection": {
      "framework": "nextjs",
      "ormType": "prisma",
      "databaseProvider": "neon"
    }
  }
}
Auto-detection
Telbase reads your config files (package.json, vite.config.ts, manage.py, go.mod, Dockerfile) to detect the framework. No configuration files to write.

Add a Database

If your project uses Prisma or Drizzle, the database is provisioned automatically on first deploy. No extra steps needed.

bash
# Check database status after deploy
telbase db status

SQLite projects get a Turso database. PostgreSQL projects get Neon. You don't need to choose — it's selected based on your schema.

bash
# Pull the connection string for local development
telbase env pull

Share With Your Team

Restrict access to your team:

bash
# 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:

bash
telbase domain add app.yourcompany.com

Redeploy

Made changes? Redeploy with one command:

bash
telbase deploy

Or connect GitHub for automatic deploys on every push:

bash
telbase github connect

Set Up Your AI Agent

Add TELBASE.md to your repo so any AI coding agent can deploy to Telbase automatically — no internet fetch needed.

bash
npx telbase init

Or download TELBASE.md manually and add it to your repo root. Works with Claude Code, Cursor, Copilot, Windsurf, and more.

Next Steps