Leash CLI

The simplest way to deploy your web applications. One command. Any framework.

Installation

npm install -g @leash/cli

Quick Start

# 1. Create an account
leash register

# 2. Go to your project directory
cd my-app

# 3. Deploy (auto-detects framework)
leash deploy

# Your app is live at https://leash.build/username/my-app

Supported Frameworks

• Next.js - Full-stack React applications
• Expo / React Native - Mobile apps deployed as web
• Vite - Modern frontend applications
• Any Node.js app - Generic Node.js applications

Commands

Authentication

leash register          # Create a new account
leash login             # Log in to your account
leash logout            # Log out
leash whoami            # Show current user

Deployment

leash deploy                        # Deploy current project
leash deploy --message "Bug fix"    # Deploy with message

App Management

leash init                  # Initialize app in current directory
leash init --name my-app    # Initialize with custom name
leash apps:list             # List all your apps
leash apps:delete <appId>   # Delete an app

Environment Variables

leash env:set KEY value     # Set environment variable
leash env:list              # List all variables
leash env:delete KEY        # Delete a variable

Databases

leash db:create                           # Create database (interactive)
leash db:create --type postgres --name db # Create with options
leash db:list                             # List all databases
leash db:connect <id>                     # Get connection details
leash db:delete <id>                      # Delete database

Logs

leash logs              # View recent logs
leash logs --lines 200  # View more lines
leash logs --follow     # Stream logs live

Configuration

leash config                    # Show current config
leash config:set-url <url>      # Set API URL (advanced)
leash config:get-url            # Get current API URL
leash config:reset              # Reset to defaults

Configuration Files

Global config stored in ~/.leash/config.json:

{
  "apiUrl": "https://leash.build/api",
  "token": "your-auth-token"
}

Project config stored in .leash/config.json:

{
  "appId": "app_123",
  "appName": "my-app"
}

Environment Variables

• LEASH_API_URL - Override API URL
• LEASH_DEV=1 - Use localhost for development

Links

• Website: https://leash.build
• Documentation: https://leash.build/docs