← Back to Documentation

Getting Started

Deploy your first application to CupaDev in under 5 minutes. No configuration needed.

How CupaDev works

CupaDev is a deployment platform built on Kubernetes. You connect your Git repository, and every push to your production branch automatically builds and deploys your app. Each project gets a unique URL (your-project.cupadev.com) with HTTPS included.

1

Connect Git

Link your GitHub repository. CupaDev auto-detects your framework (Next.js, React, Node.js, etc.).

2

Build

CupaDev installs dependencies, runs your build command, and packages the app into a Docker image.

3

Deploy

The image is deployed to Kubernetes. Your app is live at a unique URL with automatic HTTPS.

Deploy your first project

1

Go to New Project

From your dashboard, click New Project. Select Import from GitHub.

2

Select your repository

Authorize CupaDev to read your GitHub repositories, then pick the repo you want to deploy. CupaDev will auto-detect the framework.

Detected: Next.js — Build: npm run build — Output: .next
3

Add environment variables

Add any required env vars (database URL, API keys, secrets) before the first deploy. You can also import a .env file directly.

DATABASE_URL=postgresql://user:pass@host/db
NEXTAUTH_SECRET=your-secret
4

Deploy

Click Deploy. Watch the build logs in real time. When done, your app is live at your-project.cupadev.com.

Automatic deployments

Once your project is set up, every push to your production branch triggers a new deployment automatically. CupaDev registers a webhook on your GitHub repository.

How auto-deploy works

  • Push to your configured branch (default: main)
  • GitHub sends a webhook to CupaDev
  • A new build starts automatically
  • Zero-downtime swap to new version when ready

Supported frameworks

Next.js

App Router, Pages Router, standalone output

React + Vite

Static output served via S3

Vue / Nuxt

Static + SSR

Node.js / Express

TypeScript and JavaScript

NestJS

Full TypeScript support

Fastify / Koa

Any Node.js HTTP server

Next steps