Caddi
Sign inSign up

Environments

Production, staging, dev — modeled on WPEngine.

Every project ships with three real environments and a promote button. Branded preview URLs included.

The Caddi environments view for meridian-studio, showing three environment cards and a recent deploys log.

The model

Three branches map to three URLs.

Each project gets main, staging, and dev — wired to a Vercel project on your own team, with separately validated env vars. The idea hasn’t changed since WPEngine first popularized it. The execution finally caught up.

What's included

Everything an agency actually needs.

  • Three branches, three URLs

    main → production, staging → staging, dev → dev. Each is a real Vercel deploy on a real Caddi-branded subdomain.

  • Typed env vars

    Per-environment secrets and plain values, validated against the template’s schema. Diff and copy across environments.

  • Promote with one click

    A staging promotion opens a PR, runs your checks, and deploys the moment it merges. Same for prod, optionally gated on client approval.

  • Full history

    Every deploy, every env-var change, every promotion — in the audit log. Roll back to any prior commit on any environment.

  • Branded preview URLs

    Verify your agency domain once and every staging/dev deploy auto-aliases to <client>-staging.preview.<your>.com.

  • Branch-protection aware

    If your repo requires PR reviews, Caddi surfaces that gate clearly instead of blowing up the saga. Your rules, respected.

Promotion

One click, one PR, one audit-log entry.

Promotions are real GitHub pull requests, not magic. Caddi opens the PR, attaches the change summary, requests review when needed, and watches the deploy.

github · pr body
Caddi promotion: meridian-studio · staging → production

Summary
  • 3 commits since last promotion
  • 1 env var changed: STRIPE_PUBLIC_KEY (plain)
  • 0 schema migrations

Reviewers
  • @meridian-alicia (client approver)
  • Required: 1 review

→ View in Caddi:  https://app.caddi.build/northstar/sites/meridian-studio/promote/p_01H...

Branded URLs

Your agency domain. Their site.

Verify northstar.dev once and every project gets URLs like meridian-staging.preview.northstar.dev automatically — no Cloudflare console, no manual CNAMEs.

FAQ

Frequently asked.

Does this replace Vercel?
No — Caddi uses your Vercel team via OAuth and pays attention to your project settings. The deploys live on your account, you own the domains, the env vars are stored on Vercel. We orchestrate.
What about preview branches per PR?
Vercel preview deploys per PR continue to work. The three-environment model is for the long-lived branches your team and clients care about.
Can I use this with a non-Next.js framework?
Yes. The boilerplate templates ship for Next.js and Astro today, but the environment model works against any repo Vercel will deploy. Bring your own.
How does promotion work in practice?
A staging promotion creates a PR from staging into main with a short summary and a link back to the Caddi review page. Approvers can be your team, the client (via the portal), or both.

Promote your way back to a normal Tuesday.

Caddi gives every project a real environment story without making you build the plumbing.

Get started