robodev

DocsSign in

Start

Getting started

Create a Starbase project, deploy the starter, and run the UI.

Getting startedStarter projectDatabaseFile-based APIsDeployLocal developmentCLI reference

Robodev is a CLI and TypeScript library for Starbase. You describe a Postgres database and HTTP handlers as files, then deploy them to a hosted project.

Install

terminal

npm i -g robodev

Or run commands with npx robodev without a global install.

First app

terminal

robodev auth
robodev create my-space-app
cd my-space-app
npm run dev
  • auth opens Starbase in the browser and stores tokens in ~/.robodev/credentials.json.
  • create makes a Starbase project, copies the starter, writes .robodev and .env, deploys, and runs npm install.
  • npm run dev serves the React UI on http://localhost:5173 against the deployed project host.

Against a local Starbase, prefix commands with STARBASE_URL=http://localhost:4000 STARBASE_FE_URL=http://localhost:3000.

What you get

  • A space database with planets and rockets tables.
  • APIs at /health, /planets, /rockets, and /launch.
  • Swagger at http://{projectId}.localhost:4000/docs locally, or https://{projectId}.robodev.povio.dev/docs in production.
  • A small UI that reads VITE_API_URL from .env.

Next

Change database.ts or add a file under api/, then run robodev deploy. Destructive schema changes need confirmation or --force.