VarityKit CLI Overview

Varity Team Core Contributors Updated March 2026

VarityKit is a Python-based CLI that helps you build, test, and deploy applications. If you have used tools like the Vercel CLI, Netlify CLI, or Firebase CLI, you will feel right at home.

What You Can Do

Initialize Projects

Scaffold new projects from starter templates with pre-configured auth and deployment.

Deploy Applications

Deploy static sites or dynamic apps with one command.

Manage Templates

Create, test, validate, and publish templates to the marketplace.

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 init`	Create a new project from a template
`varitykit dev`	Start development servers (API + frontend)
`varitykit bootstrap`	Install project dependencies and set up 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 status`	Show deployment status
`varitykit app rollback`	Rollback to a previous deployment

Templates

Command	Description
`varitykit template create`	Create a new template with AI assistance
`varitykit template test`	Run automated tests for a template
`varitykit template preview`	Preview a template in the browser
`varitykit template validate`	Validate template quality (code, tests, a11y, security)
`varitykit template list`	List available templates
`varitykit template info`	Show detailed template information

Marketplace

Command	Description
`varitykit marketplace publish`	Publish a template to the marketplace
`varitykit marketplace search`	Search for templates
`varitykit marketplace install`	Install a template from the marketplace
`varitykit marketplace stats`	View your marketplace statistics
`varitykit marketplace unpublish`	Remove a template from the marketplace
`varitykit marketplace update`	Update a published template

Domains

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

Migration

Command	Description
`varitykit migrate s3`	Migrate data from AWS S3 to Varity
`varitykit migrate gcs`	Migrate data from Google Cloud Storage to Varity
`varitykit migrate status`	Check migration job status
`varitykit migrate verify`	Verify migration integrity

Quick Start

# Install the CLI
pip install varitykit

# Check your environment
varitykit doctor

# Log in with your developer portal deploy key
varitykit login

# Create a new project
varitykit init my-app

# Deploy (static sites)
varitykit app deploy

# Deploy (dynamic apps)
varitykit app deploy --hosting dynamic

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.8 or higher
Node.js: 18+ (for building JavaScript projects)

Hosting Options

Static Sites

Deploy static websites and single-page applications:

varitykit app deploy

Best for: Marketing sites, documentation, SPAs
Cost: Free (sponsored by Varity)
Speed: Global CDN distribution

Dynamic Apps

Deploy full-stack applications with backend:

varitykit app deploy --hosting dynamic

Best for: APIs, databases, server-side rendering
Cost: Pay for compute resources
Features: Containers, scaling, persistence

Supported Frameworks

Framework	Static	Dynamic
Next.js 13+	Yes	Yes
React (Vite)	Yes	Yes
React (CRA)	Yes	Yes
Vue 3+	Yes	Yes
Node.js	No	Yes
Python	No	Yes

Additional Command Details

dev

Start development servers (API + frontend) with hot-reload:

varitykit dev [OPTIONS]

Option	Default	Description
`--project`	`marketing`	Frontend project to run
`--api-only`	`false`	Run only the API server
`--frontend-only`	`false`	Run only the frontend
`--port`	`3001`	API server port

bootstrap

Install project dependencies and set up the environment:

varitykit bootstrap [OPTIONS]

Option	Description
`--skip-npm`	Skip npm install
`--skip-pip`	Skip pip install
`--skip-docker`	Skip Docker setup

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
Create your first project - Scaffold a project
Deploy your application - Deploy to production