Quickstart

Get your first project deployed to Droplet in under 60 seconds.

Prerequisites

  • A Droplet account — sign up free
  • A GitHub repository (GitLab and Bitbucket support are coming soon)

Step 1 — Create a new application

From your Droplet dashboard, click New Application. Give it a name (lowercase, hyphens only) and click Create.

Step 2 — Connect your repository

Go to Connect → Repository. Authorize Droplet to access your Git provider, then select the repository you want to deploy.

Terminal
# Initialize a new project locally
$ git init my-app && cd my-app
$ echo "Hello, Droplet!" > index.html
$ git add . && git commit -m "initial commit"
$ git remote add origin https://github.com/you/my-app
$ git push -u origin main

Step 3 — Configure build settings

Droplet auto-detects most frameworks. For a Next.js app, the defaults are:

SettingDefault
Build commandnpm run build
Output directory.next
Node.js version20.x

Step 4 — Deploy

Click Deploy. Droplet clones your repository, runs your build command, and publishes the output through your application's configured compute engine. Your frontend application will be live at your-app.pages.dev within seconds.

Terminal
$ git push origin main
Counting objects: 100% (5/5), done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 324 bytes | 324.00 KiB/s, done.
pages.dev
Deployment finished in 23s

Every subsequent push to main can trigger an automatic redeployment when the repository integration is enabled.