VarityKit CLI Overview Guide

Varity Team Core Contributors Updated June 2026

VarityKit is a Python-based CLI that helps you deploy and manage applications. It is a familiar deploy CLI: install it, log in, and ship.

What You Can Do

Deploy Applications

Deploy supported Node, Python, Go, static, and Docker workloads with one command.

Migrate from Vercel

Move an existing Vercel app to Varity in one step: analyze, transform, and deploy.

Manage Deployments

List deployments, view status and logs, and redeploy a known-good version when needed.

Validate Setup

Run diagnostics to ensure your development environment is ready.

Commands at a Glance

Core Commands

Command	Description
varitykit login	Log in with your deploy key from the developer portal
varitykit doctor	Validate your development environment
varitykit completions	Set up shell completions (bash, zsh, fish)

Authentication

Command	Description
varitykit auth login	Log in with your deploy key
varitykit auth logout	Remove saved credentials
varitykit auth status	Show current login status

App Deployment

Command	Description
varitykit app deploy	Deploy your application
varitykit app list	List all deployments
varitykit app info	Show deployment details
varitykit app delete --yes	Delete a deployment

Domains

Command	Description
varitykit domains list	List all domains you own on varity.app

Migration (Vercel → Varity)

Command	Description
varitykit migrate --url <github-url>	Clone a GitHub repo and migrate it to Varity (analyze + transform + deploy)
varitykit migrate --path <path>	Migrate a local Vercel project directory
varitykit migrate --dry-run	Preview what would change without modifying files
varitykit migrate --no-deploy	Apply codemods only, skip deployment
varitykit migrate analyze <path>	Scan for Vercel artifacts (read-only preview)
varitykit migrate apply <path>	Apply codemods without deploying
varitykit migrate rollback <path>	Restore files from .vercel-migration-backup/

Quick Start

# Install the CLI
pipx install varitykit

# Check your environment
varitykit doctor

# Log in with your developer portal deploy key
varitykit login

# Deploy (auto-detects static vs dynamic)
varitykit app deploy

# Or force a specific mode
varitykit app deploy --hosting dynamic
varitykit app deploy --hosting static

Global Options

All commands support these global options:

varitykit [OPTIONS] COMMAND [ARGS]...

Options:
  --version        Show the CLI version
  -v, --verbose    Enable verbose output
  --debug          Enable debug output
  --json           Output in JSON format
  --help           Show help message

Requirements

• Python: 3.11 or higher
• Node.js: 20+ (for building JavaScript projects)

Tip

Run varitykit doctor to automatically check all requirements and get installation guidance for missing dependencies.

Hosting Options

Static Sites

Deploy static websites and single-page applications:

varitykit app deploy

• Best for: Marketing sites, documentation, SPAs
• Cost: One flat monthly cost per app. Your bill on day 1 equals your bill on day 1000. See the pricing calculator.
• Speed: Global CDN distribution

Dynamic Apps

Deploy full-stack applications with backend:

varitykit app deploy --hosting dynamic

• Best for: APIs, databases, server-side rendering, AI agents, LLMs
• Cost: One flat monthly cost per app, based on the hardware you reserve. See the pricing calculator.
• Features: Containers, scaling, persistence

Varity auto-detects when your app needs dynamic hosting (Express, Fastify, Next.js SSR, FastAPI, Django, Flask, etc.) and selects it automatically. Use --hosting dynamic only to force the mode explicitly.

Supported Frameworks

Varity currently auto-detects and deploys the following frameworks:

Framework	Static	Dynamic
Next.js 13+	Supported	Supported
React (Vite)	Supported	Supported
React (CRA)	Supported	Supported
Vue 3+	Supported	Supported
Express, Fastify, Nest, Koa, Hono	Not applicable	Supported
FastAPI, Django, Flask	Not applicable	Supported
Go modules	Not applicable	Supported
Plain static HTML	Supported	Not applicable
Runnable Docker/OCI HTTP images	Not applicable	Supported

Not yet source-built: Rust, Ruby / Rails, Elixir / Phoenix, Java / Spring, Deno, PHP / Laravel, .NET. These return a clean unsupported-stack error as source projects. Deploy them today with a runnable Docker/OCI image, or request source-build support.

Additional Command Details

completions

Set up shell completions for the CLI:

varitykit completions [OPTIONS]

Option	Description
--shell	Shell type: bash, zsh, or fish (auto-detected if omitted)
--install	Install completions to your shell config file

Next Steps

• Install the CLI: Installation guide
• Log in: Connect your developer account
• Run diagnostics: Check your setup
• Deploy your application: Deploy to production