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.
# 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:
| Setting | Default |
|---|---|
| Build command | npm run build |
| Output directory | .next |
| Node.js version | 20.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.
$ git push origin mainCounting objects: 100% (5/5), done.Compressing objects: 100% (3/3), done.Writing objects: 100% (3/3), 324 bytes | 324.00 KiB/s, done.✓ pages.devDeployment 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.