feat: Support prisma >6.7 in standard starter

[justinvdm]

Context

• Updates the standard starter
  • to use prisma 6.7
  • to use the new prisma-client generator: prisma will now generate code to a gitignored generated/prisma dir
  • to use the new queryCompiler flag to reduce the size of the WASM (by around ~350KB)

---

🔁 Prisma >6.7 migration guide for existing projects

Prisma introduced a new client generator (prisma-client) that lets us generate a client specific to Cloudflare workers (via workerd runtime) and ESM - this makes for much simpler and less error prone Vite integration.

This guide walks you through upgrading an existing RedwoodSDK Standard Starter project.

1. ✅ Update Dependencies

Update the following packages in your package.json:

- "@prisma/adapter-d1": "~6.5.0",
- "@prisma/client": "~6.5.0",
- "prisma": "~6.5.0",
+ "@prisma/adapter-d1": "~6.8.2",
+ "@prisma/client": "~6.8.2",
+ "prisma": "~6.8.2",

Also upgrade wrangler to at least ^4.16.0.

- "wrangler": "^4.14.1"
+ "wrangler": "^4.16.0"

---

**2. 🧬 Update **

schema.prisma

Change the generator block to use the new prisma-client:

-generator client {
-  provider        = "prisma-client-js"
-  previewFeatures = ["driverAdapters"]
-  output          = "../node_modules/.prisma/client"
+generator client {
+  provider = "prisma-client"
+  runtime = "workerd"
+  moduleFormat = "esm"
+  generatedFileExtension = "ts"
+  importFileExtension = "ts"
+  output = "../generated/prisma"
+  previewFeatures = ["queryCompiler", "driverAdapters"]
}

---

3. 🗂️ Adjust TypeScript Paths

In tsconfig.json:

- ".prisma/*": ["./node_modules/.prisma/*"]
+"@/*": ["./src/*"],
+ "@generated/*": ["./generated/*"]

Then update imports from @prisma/client to @/db.

---

4. 🛠️ Refactor DB Client Usage

Replace your src/db.ts with the latest in the standard starter:

https://github.com/redwoodjs/sdk/blob/main/starters/standard/src/db.ts

---

5. 📁 Add to .gitignore

+generated/

---

6. 📦 Re-generate Client

After updating schema.prisma:

pnpm prisma generate

---

7. 🧪 Test Everything

Check your queries work in development and deployments.

---

Notes

Steps taken

https://gist.github.com/justinvdm/24a9f316f7c5148be852c4660e5f0481

Update: 22 May 2025

• We're now in a position to merge this, working as expected in dev and production, see steps taken for more

Update: 21 May 2025

• Submitted PR for the relevant fix required in @cloudflare/vite-plugin: fix(vite-plugin): Support __ in additional module IDs cloudflare/workers-sdk#9322
• Got this PR working on both prisma <6.7 and >6.7 (assuming fix(vite-plugin): Support __ in additional module IDs cloudflare/workers-sdk#9322 fix is in and PR upgraded to use it)
• See action log for more detail on steps taken

Update: 19 May 2025

• Goal: ==Upgrade to Prisma >=6.7, remove Prisma-specific Vite logic from RedwoodSDK, avoid WASM if possible, and maintain backwards compatibility.

• Steps Taken:

  • Upgraded to Prisma 6.8.2 with queryCompiler and driverAdapters.

  • Tried out different vite configurations and aliases to target new Prisma client structure.

  • Tested various entry points (edge.js, index.js, wasm.js) and generation configs

  • Validated new prisma-client generator for workerd + esm output.

• Current Status: Generated client works and loads in dev with SDK changes. DB client instantiation succeeds. Queries fail due to WASM module resolution error during runtime.

• Blocking Issue: Cloudflare's Vite plugin fails to resolve Prisma's WASM module path, likely due to pnpm's path format (__) interfering with Cloudflare's module detection regex. Investigating patch to regex logic in @cloudflare/vite-plugin.

• Findings:

  • Not WASM free (yet?): Prisma is not WASM free yet, but they're gradually moving the components out of rust into ts. There's still a 1.66MB wasm file we must work with. Previously it was 2MB.

  • Cloudflare's plugin appears to mangle WASM imports when the file path includes double underscores (__), likely due to greedy regex

  • Switching to Prisma's new ESM generator is promising for us to avoid complexities - e.g. we can avoid having to get optimizeDeps to esm-ify the requires in the generated prisma client (though we'll still need some logic for <6.7)

• Next Step: Investigate patch, then corresponding PR for Cloudflare's Vite plugin to fix its WASM module resolution regex handling for __ in paths.

[cloudflare-workers-and-pages]

Deploying redwood-sdk-docs with    Cloudflare Pages

Latest commit:	3c685aa
Status:	✅  Deploy successful!
Preview URL:	https://dfc273eb.redwood-sdk-docs.pages.dev
Branch Preview URL:	https://prisma-6-8-2.redwood-sdk-docs.pages.dev

View logs