Caddi
Sign inSign up

Your first project

From an empty agency to a deployed site with three environments and a wired form endpoint, in under a minute.

1. Pick a template

Caddi ships with six maintained templates:

  • next-marketing — Next.js 15 + MDX, ready for content.
  • astro-marketing — Astro + content collections.
  • next-portfolio — Next.js portfolio with case-study CMS.
  • astro-local — Astro local-business with reviews and contact.
  • next-ecommerce — Next.js + Stripe minimal storefront.
  • astro-docs — Astro Starlight for product docs.

Every template ships with @caddi/forms-sdk wired, an AGENTS.md for coding agents, dark/light mode, and the three-branch convention.

2. Click “New project”

From the agency dashboard: Projects → New project. You’ll be asked for a template, a name, an assigned client, and an optional client portal invite.

3. Watch the saga run

Caddi runs an Inngest job that does seven things, with rollback if any step fails:

caddi.saga
✓ create repo            northstar/meridian-studio
✓ create branches        main · staging · dev
✓ create vercel project  meridian-studio  (linked to repo)
✓ apply env-var schema   14 vars across 3 envs
✓ insert project record
✓ assign preview URLs    meridian-{staging,dev}.preview.northstar.dev
✓ send portal invite     [email protected]  (skipped — no client invite)
Mid-flight failures roll back cleanly. You’ll see exactly which step failed and what was attempted. The mutation has an idempotency key, so a double-click can’t produce two repos.

4. Promote a deploy

From the project page, click Promote dev → staging. Caddi opens a PR from dev into staging, attaches a change summary, and watches Vercel for the deploy status.

Next