Skip to content
Varity Docs

Next.js Quick Start

Varity Team Core Contributors Updated May 2026

Deploy an existing Next.js app to Varity in one command. Varity detects your framework, picks the right hosting mode, and wires any backend services your app needs automatically. You do not change your code.

Prerequisites

Section titled “Prerequisites”
  • Node.js 20 or later
  • npm, pnpm, or yarn
  • Python 3.8+ (for the CLI)

Deploy your app

Section titled “Deploy your app”

  1. Install the CLI

    Terminal window
    pipx install varitykit

  2. Open your project

    Terminal window
    cd my-app

  3. Confirm it runs locally (optional)

    Terminal window
    pnpm install
    pnpm dev

    Open http://localhost:3000 to confirm your app works before deploying.

  4. Deploy to Varity

    Terminal window
    varitykit app deploy

    Varity detects that this is a Next.js project, chooses the right hosting mode (static export or dynamic runtime), builds your app, and deploys it.

  5. Your app is live

    The terminal shows your live URL:

    https://varity.app/<app-name>/

What gets auto-wired

Section titled “What gets auto-wired”

You do not import an SDK or change your code. When Varity deploys a Next.js project, it configures the backend automatically:

  • Hosting mode - static export vs dynamic runtime is detected from your next.config.js.
  • Databases and caches - if Varity detects a database client in your dependencies (for example Prisma, pg, mongoose, or redis), it provisions the matching service and injects the connection details into your app’s environment at runtime.
  • Environment variables - any variables you set are injected into the deployed container. See Environment Variables.
  • Live URL - https://varity.app/<app-name>/, with HTTPS handled for you.

For the full list of detected frameworks and auto-wired services, see Supported Frameworks and Auto-wired Services.

Next Steps

Section titled “Next Steps”