@edgebasejs/cli

Complete command-line tooling for EdgeBase. Build, develop, and deploy your backend with a separate admin console.

Install

npm install -g @edgebasejs/cli

Or locally:

npm install -D @edgebasejs/cli

Commands

Development & Deployment

# Start development server
edgebase dev
# Opens: http://localhost:8787 (Worker)
#        http://localhost:3001 (Admin, monorepo mode)

# Build worker
edgebase build

# Publish worker to npm
edgebase publish
# Admin console is published/deployed separately

Schema Management

# Generate migrations and client SDKs from schema
edgebase generate

# Apply migrations to database
edgebase migrate

# Initialize a new EdgeBase project
edgebase init

Smart Detection

The CLI automatically detects your setup:

• Monorepo: Uses monorepo packages/apps (packages/worker, apps/admin-console) and starts both
• NPM: Uses published npm packages (@edgebasejs/worker, @edgebasejs/admin-console)

Examples

Monorepo Development

# Start dev server with both worker and admin console
npm run dev

# Build everything
npm run build

# Publish to npm
npm run publish:worker

Using Published Packages

# Install worker package
npm install @edgebasejs/worker

# Start development (uses npm packages)
npx edgebase dev

# Build for deployment
npx edgebase build

# Deploy to Cloudflare Workers
npx edgebase publish

Notes

The CLI expects a worker project with an EdgeBase schema file. Run it from the worker directory or repo root.