Core Concepts

Understanding how Droplet models your work makes everything else click.

Applications

An application is the top-level resource in Droplet. It maps to a single repository and acts as the container for all deployments, domains, storage buckets, and settings.

Deployments

A deployment is an immutable snapshot of your application at a specific Git commit. Every push creates a new deployment. Deployments are never mutated — a rollback simply promotes an older deployment to production.

Environments

Droplet has two environments per application:

  • Production — your main branch, served at your custom domain or app.pages.dev
  • Preview — every other branch gets its own isolated URL automatically

Environment variables can be scoped to Production only, Preview only, or both.