feat: add dodo as a payment provider

apps/cli/README.md

@@ -58,7 +58,7 @@ Options:
   --orm <type>                    ORM type (none, drizzle, prisma, mongoose)
   --dry-run                       Validate configuration without writing files
   --auth <provider>               Authentication (better-auth, clerk, none)
-  --payments <provider>           Payments provider (polar, none)
+  --payments <provider>           Payments provider (polar, dodo, none)
   --frontend <types...>           Frontend types (tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, astro, native-bare, native-uniwind, native-unistyles, none)
   --addons <types...>             Additional addons (pwa, tauri, electrobun, starlight, biome, lefthook, husky, mcp, turborepo, nx, fumadocs, ultracite, oxlint, opentui, wxt, skills, none)
   --examples <types...>           Examples to include (todo, ai, none)

apps/cli/src/helpers/addons/mcp-setup.ts

@@ -186,6 +186,12 @@ function getAllMcpServers(config: ProjectConfig): McpServerDef[] {
       name: "polar",
       target: "https://mcp.polar.sh/mcp/polar-mcp",
     },
+    {
+      key: "dodo",
+      label: "Dodo Payments",
+      name: "dodo",
+      target: "https://docs.dodopayments.com/mcp",
+    },
   ];
 }
 
@@ -260,6 +266,10 @@ export function getRecommendedMcpServers(
     recommendedServerKeys.push("polar");
   }
 
+  if (config.payments === "dodo") {
+    recommendedServerKeys.push("dodo");
+  }
+
   return uniqueValues(recommendedServerKeys)
     .map((serverKey) => serversByKey.get(serverKey))
     .filter((server): server is McpServerDef => server !== undefined);

apps/cli/src/prompts/payments.ts

@@ -16,12 +16,12 @@ export async function getPaymentsChoice(
     return "none" as Payments;
   }
 
-  const isPolarCompatible =
+  const isProviderCompatible =
     auth === "better-auth" &&
     backend !== "convex" &&
     (frontends?.length === 0 || splitFrontends(frontends).web.length > 0);
 
-  if (!isPolarCompatible) {
+  if (!isProviderCompatible) {
     return "none" as Payments;
   }
 
@@ -31,6 +31,11 @@ export async function getPaymentsChoice(
       label: "Polar",
       hint: "Turn your software into a business. 6 lines of code.",
     },
+    {
+      value: "dodo" as Payments,
+      label: "Dodo Payments",
+      hint: "Payments, billing, and distribution. One integration.",
+    },
     {
       value: "none" as Payments,
       label: "None",

apps/cli/src/utils/compatibility-rules.ts

@@ -317,17 +317,18 @@ export function validatePaymentsCompatibility(
 ): ValidationResult {
   if (!payments || payments === "none") return Result.ok(undefined);
 
-  if (payments === "polar") {
+  if (payments === "polar" || payments === "dodo") {
+    const providerLabel = payments === "polar" ? "Polar" : "Dodo";
     if (!auth || auth === "none" || auth !== "better-auth") {
       return validationErr(
-        "Polar payments requires Better Auth. Please use '--auth better-auth' or choose a different payments provider.",
+        `${providerLabel} payments requires Better Auth. Please use '--auth better-auth' or choose a different payments provider.`,
       );
     }
 
     const { web } = splitFrontends(frontends);
     if (web.length === 0 && frontends.length > 0) {
       return validationErr(
-        "Polar payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.",
+        `${providerLabel} payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.`,
       );
     }
   }

apps/cli/test/addon-setup-regressions.test.ts

@@ -97,6 +97,12 @@ describe("Addon setup regressions", () => {
     expect(betterTStackServer?.target).toBe("bunx create-better-t-stack@latest mcp");
   });
 
+  it("recommends the Dodo MCP server when Dodo payments are selected", () => {
+    const servers = getRecommendedMcpServers(createProjectConfig({ payments: "dodo" }), "project");
+
+    expect(servers.some((server) => server.key === "dodo")).toBe(true);
+  });
+
   it("preserves explicit empty MCP selections in silent mode", async () => {
     const projectDir = path.join(SMOKE_DIR, "mcp-explicit-empty");
     await fs.remove(projectDir);

apps/cli/test/integration.test.ts

@@ -521,6 +521,28 @@ describe("Integration Tests - Real World Scenarios", () => {
       expectError(result, "Polar payments requires Better Auth");
     });
 
+    it("should fail with Dodo payments incompatibility", async () => {
+      const result = await runTRPCTest({
+        projectName: "dodo-no-auth-fail",
+        backend: "hono",
+        runtime: "bun",
+        database: "none",
+        orm: "none",
+        auth: "none",
+        payments: "dodo",
+        api: "trpc",
+        frontend: ["tanstack-router"],
+        addons: ["turborepo"],
+        examples: ["none"],
+        dbSetup: "none",
+        webDeploy: "none",
+        serverDeploy: "none",
+        expectError: true,
+      });
+
+      expectError(result, "Dodo payments requires Better Auth");
+    });
+
     it("should fail with deployment constraint violation", async () => {
       const result = await runTRPCTest({
         projectName: "web-deploy-no-frontend-fail",

apps/cli/test/payments-dodo.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "bun:test";
+import path from "node:path";
+
+import fs from "fs-extra";
+
+import { create } from "../src/index";
+
+const SMOKE_DIR_PATH = path.join(import.meta.dir, "..", ".smoke");
+
+describe("Dodo payments generation", () => {
+  it("emits Dodo deps and env vars for a reference stack", async () => {
+    const projectPath = path.join(SMOKE_DIR_PATH, "dodo-reference-stack");
+    await fs.remove(projectPath);
+
+    const result = await create(projectPath, {
+      frontend: ["next"],
+      backend: "hono",
+      runtime: "node",
+      database: "none",
+      orm: "none",
+      api: "trpc",
+      auth: "better-auth",
+      payments: "dodo",
+      addons: ["turborepo"],
+      examples: ["none"],
+      dbSetup: "none",
+      webDeploy: "none",
+      serverDeploy: "none",
+      install: false,
+      git: true,
+      packageManager: "bun",
+      disableAnalytics: true,
+      directoryConflict: "overwrite",
+    });
+
+    expect(result.isOk()).toBe(true);
+
+    const authPkgPath = path.join(projectPath, "packages", "auth", "package.json");
+    const webPkgPath = path.join(projectPath, "apps", "web", "package.json");
+    const serverEnvPath = path.join(projectPath, "apps", "server", ".env");
+    const paymentsPath = path.join(projectPath, "packages", "auth", "src", "lib", "payments.ts");
+    const successPath = path.join(
+      projectPath,
+      "apps",
+      "web",
+      "src",
+      "app",
+      "payment",
+      "success",
+      "page.tsx",
+    );
+
+    const authPkg = await fs.readJson(authPkgPath);
+    const webPkg = await fs.readJson(webPkgPath);
+    const serverEnv = await fs.readFile(serverEnvPath, "utf8");
+
+    expect(authPkg.dependencies?.["@dodopayments/better-auth"]).toBeDefined();
+    expect(authPkg.dependencies?.dodopayments).toBeDefined();
+    expect(webPkg.dependencies?.["@dodopayments/better-auth"]).toBeDefined();
+    expect(serverEnv).toContain("DODO_PAYMENTS_API_KEY=");
+    expect(serverEnv).toContain("DODO_PAYMENTS_WEBHOOK_SECRET=");
+    expect(serverEnv).toContain("DODO_PAYMENTS_ENVIRONMENT=");
+    expect(await fs.pathExists(paymentsPath)).toBe(true);
+    expect(await fs.pathExists(successPath)).toBe(true);
+  });
+});

apps/web/content/docs/cli/compatibility.mdx

@@ -199,7 +199,7 @@ Clerk authentication requires:
 
 ### Payments Requirements
 
-Polar payments require:
+Polar and Dodo payments require:
 
 - Better-Auth authentication
 - A web frontend (or no frontend selected)
@@ -258,11 +258,12 @@ create-better-t-stack --runtime workers --backend hono
 create-better-t-stack --frontend tanstack-router
 ```
 
-### "Polar payments requires Better Auth"
+### "Polar/Dodo payments requires Better Auth"
 
 ```bash
 # Fix by using Better-Auth
 create-better-t-stack --payments polar --auth better-auth
+create-better-t-stack --payments dodo --auth better-auth
 
 # Or use Clerk without Polar payments
 create-better-t-stack --auth clerk --backend hono --frontend tanstack-router

apps/web/content/docs/cli/index.mdx

@@ -35,7 +35,7 @@ create-better-t-stack [project-directory] [options]
 - `--orm <type>`: `none`, `drizzle`, `prisma`, `mongoose`
 - `--api <type>`: `none`, `trpc`, `orpc`
 - `--auth <provider>`: `better-auth`, `clerk`, `none` (see [Options](/docs/cli/options#authentication))
-- `--payments <provider>`: `polar`, `none`
+- `--payments <provider>`: `polar`, `dodo`, `none`
 - `--db-setup <setup>`: `none`, `turso`, `d1`, `neon`, `supabase`, `prisma-postgres`, `planetscale`, `mongodb-atlas`, `docker`
 - `--examples <types...>`: `none`, `todo`, `ai`
 - `--web-deploy <setup>`: `none`, `cloudflare`

apps/web/content/docs/cli/options.mdx

@@ -287,12 +287,14 @@ Payments provider:
 
 - `none`: No payments integration
 - `polar`: Polar payments integration
+- `dodo`: Dodo Payments integration
 
 ```bash
 create-better-t-stack --payments polar --auth better-auth
+create-better-t-stack --payments dodo --auth better-auth
 ```
 
-**Note:** Polar payments requires Better-Auth authentication.
+**Note:** Payments providers require Better-Auth authentication.
 
 ## Addons
 

apps/web/content/docs/index.mdx

@@ -94,7 +94,7 @@ See the full list in the [CLI Reference](/docs/cli). Key flags:
 - `--orm`: drizzle, prisma, mongoose, none
 - `--api`: trpc, orpc, none
 - `--auth`: better-auth, clerk, none
-- `--payments`: polar, none
+- `--payments`: polar, dodo, none
 - `--addons`: turborepo, nx, pwa, tauri, electrobun, biome, lefthook, husky, starlight, fumadocs, ultracite, oxlint, mcp, opentui, wxt, skills, none
 - `--examples`: todo, ai, none
 

apps/web/src/app/(home)/new/_components/utils.ts

@@ -546,21 +546,22 @@ export const analyzeStackCompatibility = (stack: StackState): CompatibilityResul
   // PAYMENTS CONSTRAINTS
   // ============================================
 
-  if (nextStack.payments === "polar") {
+  if (nextStack.payments === "polar" || nextStack.payments === "dodo") {
+    const providerLabel = nextStack.payments === "polar" ? "Polar" : "Dodo";
     if (nextStack.auth !== "better-auth") {
       nextStack.payments = "none";
       changed = true;
       changes.push({
         category: "payments",
-        message: "Payments set to 'None' (Polar requires Better Auth)",
+        message: `Payments set to 'None' (${providerLabel} requires Better Auth)`,
       });
     }
     if (nextStack.backend === "convex") {
       nextStack.payments = "none";
       changed = true;
       changes.push({
         category: "payments",
-        message: "Payments set to 'None' (Polar incompatible with Convex)",
+        message: `Payments set to 'None' (${providerLabel} incompatible with Convex)`,
       });
     }
     const hasWebFrontend = nextStack.webFrontend.some((f) => f !== "none");
@@ -569,7 +570,7 @@ export const analyzeStackCompatibility = (stack: StackState): CompatibilityResul
       changed = true;
       changes.push({
         category: "payments",
-        message: "Payments set to 'None' (Polar requires web frontend)",
+        message: `Payments set to 'None' (${providerLabel} requires web frontend)`,
       });
     }
   }
@@ -754,8 +755,8 @@ export const getDisabledReason = (
         return `Convex AI example only supports React-based frontends (not ${frontendName})`;
       }
     }
-    if (category === "payments" && optionId === "polar") {
-      return "Polar is not compatible with Convex";
+    if (category === "payments" && (optionId === "polar" || optionId === "dodo")) {
+      return `${optionId === "polar" ? "Polar" : "Dodo"} is not compatible with Convex`;
     }
   }
 
@@ -1008,12 +1009,13 @@ export const getDisabledReason = (
   // ============================================
   // PAYMENTS CONSTRAINTS
   // ============================================
-  if (category === "payments" && optionId === "polar") {
+  if (category === "payments" && (optionId === "polar" || optionId === "dodo")) {
+    const providerLabel = optionId === "polar" ? "Polar" : "Dodo";
     if (currentStack.auth !== "better-auth") {
-      return "Polar requires Better Auth";
+      return `${providerLabel} requires Better Auth`;
     }
     if (!currentStack.webFrontend.some((f) => f !== "none")) {
-      return "Polar requires a web frontend";
+      return `${providerLabel} requires a web frontend`;
     }
   }
 

apps/web/src/lib/constant.ts

@@ -455,6 +455,15 @@ export const TECH_OPTIONS: Record<
       color: "from-purple-400 to-purple-600",
       default: false,
     },
+    {
+      id: "dodo",
+      name: "Dodo Payments",
+      description: "Payments, billing, and distribution. One integration.",
+      // need to update the dodo logo in r2
+      icon: `${ICON_BASE_URL}/dodo.svg`,
+      color: "from-amber-400 to-amber-600",
+      default: false,
+    },
     {
       id: "none",
       name: "No Payments",

packages/template-generator/src/processors/env-vars.ts

@@ -448,6 +448,21 @@ function buildServerVars(
       value: `${corsOrigin}/success?checkout_id={CHECKOUT_ID}`,
       condition: payments === "polar",
     },
+    {
+      key: "DODO_PAYMENTS_API_KEY",
+      value: "",
+      condition: payments === "dodo",
+    },
+    {
+      key: "DODO_PAYMENTS_WEBHOOK_SECRET",
+      value: "",
+      condition: payments === "dodo",
+    },
+    {
+      key: "DODO_PAYMENTS_ENVIRONMENT",
+      value: "test_mode",
+      condition: payments === "dodo",
+    },
     {
       key: "CORS_ORIGIN",
       value: corsOrigin,