Cannot find module '@prisma/studio-core/data/ppg' when embedding Prisma Studio in Next.js

[sisu-01]

Question

Hi everyone,

I'm trying to embed Prisma Studio into my Next.js application by following the official guide:
https://github.com/prisma/web/blob/main/apps/docs/content/docs/guides/integrations/embed-studio.mdx

However, I encountered a module resolution error in my route.ts:

TypeScript
import { createPrismaPostgresHttpClient } from "@prisma/studio-core/data/ppg";
// Error: Cannot find module '@prisma/studio-core/data/ppg' or its corresponding type declarations.
When checking inside node_modules/@prisma/studio-core/, the data/ppg directory does not seem to exist.

Here is my environment and package.json dependencies:

JSON
"dependencies": {
"@prisma/adapter-pg": "^7.8.0",
"@prisma/client": "^7.8.0",
"@prisma/extension-accelerate": "^3.0.1",
"@prisma/studio-core": "^0.31.1",
"dotenv": "^17.4.2",
"next": "16.2.9",
"pg": "^8.21.0",
"react": "19.2.4",
"react-dom": "19.2.4"
}
Has anyone faced this issue? Has the export path for createPrismaPostgresHttpClient changed in recent versions, or am I missing a specific configuration/dependency?

Any help or workarounds would be greatly appreciated. Thanks!

• OS: Windows
• Database: PostgreSQL
• Node.js version: 22.19.0

prisma : 7.8.0
@prisma/client : 7.8.0
Operating System : win32
Architecture : x64
Node.js : v22.19.0
TypeScript : 5.9.3
Query Compiler : enabled
PSL : @prisma/prisma-schema-wasm 7.8.0-6.3c6e192761c0362d496ed980de936e2f3cebcd3a
Schema Engine : schema-engine-cli 3c6e192761c0362d496ed980de936e2f3cebcd3a (at node_modules@prisma\engines\schema-engine-windows.exe)
Default Engines Hash : 3c6e192761c0362d496ed980de936e2f3cebcd3a
Studio : 0.27.3

[DucMinhNe]

The export is real, but it only ships on the preview/dev build of @prisma/studio-core, not on the stable latest you installed.

You have "@prisma/studio-core": "^0.31.1", which resolves to 0.31.1 (the current latest dist-tag). I checked its package.json exports and ./data/ppg simply isn't there — the only ./data/* subpaths published on stable are:

./data           ./data/bff        ./data/mysql-core   ./data/mysql2
./data/node-sqlite  ./data/pglite  ./data/postgres-core  ./data/postgresjs
./data/sqlite-core  ./data/sqljs

No ./data/ppg and no ./data/accelerate, so TypeScript/Node can't resolve @prisma/studio-core/data/ppg and createPrismaPostgresHttpClient is unreachable. That's exactly the error you're seeing.

The embed-studio guide is written against the dev channel, where the subpath does exist:

// @prisma/studio-core@dev -> exports includes:
"./data/ppg":   { "import": { "types": "./dist/data/ppg/index.d.ts", "default": "./dist/data/ppg/index.js" }, ... },
"./data/accelerate": { ... }

and ./data/ppg/index.d.ts exports createPrismaPostgresHttpClient (plus PrismaPostgresHttpClientParams, RawResponse).

Fix

Install the dev/preview build instead of the stable one:

npm install @prisma/studio-core@dev

That pulls a 0.0.0-dev.* version (currently 0.0.0-dev.202601192212) where the import resolves. Verified in a clean project:

npm install @prisma/studio-core@dev
node --input-type=module -e "import { createPrismaPostgresHttpClient } from '@prisma/studio-core/data/ppg'; console.log(typeof createPrismaPostgresHttpClient)"
# -> function

A couple of things worth knowing so you don't get surprised later:

• Pin it explicitly (e.g. "@prisma/studio-core": "0.0.0-dev.202601192212") rather than leaving @dev floating, since the dev tag moves and the API in this area is still changing.
• It's a preview API, so treat the embedding integration as unstable until ppg lands on a stable release.

So nothing is wrong with your config — the guide just targets the preview build and ^0.31.1 gave you stable, which doesn't expose that subpath yet.

[sisu-01]

thank you!