Quickstart

Import a GitHub project, activate a plan, and get it deployed.

Prerequisites

  • A Droplet account — sign up free
  • A GitHub repository (GitLab and Bitbucket are not available yet)

Step 1 - Open New Application

From your dashboard, click New Application. GitHub is the currently supported provider. If GitHub is not connected, choose Connect GitHub account and authorize access.

Step 2 - Import and configure the repository

Search the repository list and click Import. Confirm the application name, production branch, and detected framework. Names must use lowercase letters, numbers, and hyphens.

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 - Choose a plan and pay

Select Starter or Standard. New applications receive one ₦3,000 credit valid for 30 days. The credit makes the first Starter payment ₦0 and reduces the first Standard payment to ₦2,000. A temporary ₦50 card verification may appear and is refunded after authorization. Payment is required before the application is activated and provisioned.

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

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

Step 4 - Provision and deploy

After Paystack confirms payment, Droplet provisions the application, connects the repository, and starts the first deployment. Frontend applications normally use a pages.dev URL; API and some Standard full-stack applications may use a workers.devURL instead. The exact URL is shown in the application dashboard.

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

Subsequent pushes to the configured production branch can trigger an automatic redeployment. Other branches may produce preview deployments when preview builds are enabled by the provider.