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.