varitykit app deploy

Varity Team Core Contributors Updated May 2026

Deploy your application to Varity’s secure infrastructure.

Usage

varitykit app deploy [OPTIONS]

Hosting Options

Static Sites

Deploy static websites and single-page applications:

varitykit app deploy

Best for:

Marketing websites
Documentation sites
Single-page applications
Landing pages

Features:

Global CDN distribution
Permanent deployment URLs
Automatic SSL
One flat monthly cost per app, your bill does not change with traffic

Dynamic Apps

Deploy full-stack applications with compute resources:

varitykit app deploy --hosting dynamic

Best for:

APIs and backends
Server-side rendering
Database applications
Full-stack apps

Features:

Container hosting
Persistent storage
One flat monthly cost per app. Your bill does not change with traffic

Options

Option	Default	Description
`--hosting`	`auto`	Hosting type: `auto`, `static`, or `dynamic`
`--path`	`.`	Project directory
`--name`	-	Custom app name. Static URLs use `varity.app/{name}`; dynamic URLs use `{name}.varity.app`
`--mode`	`auto`	Deployment mode: `auto`, `guided`, or `expert`

Basic Deployment

Build your project
Terminal window
```
npm run build
```
Deploy
Terminal window
```
varitykit app deploy
```

View your live app

✓ Build complete
✓ Deployed successfully
✓ Registered on Varity

Your app is live at:
https://your-app.varity.app

Deployment ID: deploy-1737492000

Supported Frameworks

The CLI automatically detects your framework:

Framework	Detection	Build Command
Next.js	`next.config.*`	`npm run build`
React (Vite)	`vite.config.*`	`npm run build`
React (CRA)	`react-scripts`	`npm run build`
Vue	`vue.config.*`	`npm run build`
Custom	`package.json`	`npm run build`

Environment Variables

Storage and service credentials are auto-provided by Varity. No manual credential setup is required. See Managed Credentials.

Rollback

Revert to a previous deployment:

varitykit app rollback deploy-1737491000

List Deployments

View all deployments:

varitykit app list

Output:

ID                  | Status  | URL
--------------------|---------|---------------------------
deploy-1737492000   | live    | https://your-app.varity.app
deploy-1737491000   | archived| https://your-app.varity.app (archived)

View Deployment Details

Get detailed information about a specific deployment:

varitykit app info deploy-1737492000

Check Status

View overall deployment status:

varitykit app status

Troubleshooting

”Build failed”

Verify your build works locally:
Terminal window
```
npm run build
```
Check for missing dependencies:
Terminal window
```
npm install
```

“Upload failed”

Verify network connectivity:
Terminal window
```
varitykit doctor
```
Check your internet connection and try again

Advanced: Deployment Manifest

After deployment, a manifest file is created:

{
  "deployment_id": "deploy-1737492000",
  "timestamp": "2026-01-28T12:00:00Z",
  "hosting": "static",
  "url": "https://varity.app/your-app/"
}

Next Steps

Deploy Your App - Deployment details
Configure environment variables - Required setup
CLI Overview - All CLI commands

Quick Start - Complete tutorial
Troubleshooting - Fix common issues
Auto-wired Services - Databases and caches configured automatically