From 8fae29655df8c675b55353a7a54592f61001109b Mon Sep 17 00:00:00 2001 From: Ankur Datta <64993082+ankur-arch@users.noreply.github.com> Date: Wed, 19 Nov 2025 18:55:07 +0600 Subject: [PATCH] fix: clarify studio better --- .../100-quickstart/400-mysql.mdx | 2 ++ .../200-orm/400-tools/06-prisma-studio.mdx | 19 +++++++++++++------ .../300-database/675-prisma-studio/index.mdx | 6 ++++-- 3 files changed, 19 insertions(+), 8 deletions(-) diff --git a/content/100-getting-started/02-prisma-orm/100-quickstart/400-mysql.mdx b/content/100-getting-started/02-prisma-orm/100-quickstart/400-mysql.mdx index 9e8076c696..f26f899dc9 100644 --- a/content/100-getting-started/02-prisma-orm/100-quickstart/400-mysql.mdx +++ b/content/100-getting-started/02-prisma-orm/100-quickstart/400-mysql.mdx @@ -27,6 +27,8 @@ You also need: - A [MySQL](https://www.mysql.com/) database server running and accessible - Database connection details (host, port, username, password, database name) +## 1. Create a new project + ## 2. Install required dependencies diff --git a/content/200-orm/400-tools/06-prisma-studio.mdx b/content/200-orm/400-tools/06-prisma-studio.mdx index b54aff4053..6a3592f826 100644 --- a/content/200-orm/400-tools/06-prisma-studio.mdx +++ b/content/200-orm/400-tools/06-prisma-studio.mdx @@ -5,9 +5,11 @@ metaDescription: 'Prisma Studio is a visual database editor.' toc_max_heading_level: 2 --- -Prisma Studio is a standalone visual database editor that lets you view and manipulate data directly in your browser. Unlike previous versions, Prisma Studio is now SQL-driven and works independently of Prisma ORM—you can use it with any database without needing a Prisma schema or project. +Prisma Studio is a standalone visual database editor that lets you view and manipulate data directly in your browser. Prisma 7 introduces a brand new standalone Studio, built from the ground up to work everywhere, with or without Prisma ORM. -Note that Prisma Studio is not open source but you can still create issues in the [`prisma/studio`](https://github.com/prisma/studio) repo. +Unlike previous versions, the new Prisma Studio is SQL-driven and does not rely on the Prisma schema file at all. Instead, it introspects your database directly to understand the schema structure. This means you can use it with any supported database without needing a Prisma schema or project. + +Note that Prisma Studio is not open source but you can still create issues in the [`prisma/studio`](https://github.com/prisma/studio) repo. All "old Studio" issues are being closed as there won't be any further work on the previous version. ## Prerequisites @@ -25,12 +27,17 @@ This approach works without any Prisma ORM setup—Studio will introspect your d ### Option 2: Use with a Prisma ORM project -If you have an existing Prisma project, Studio can read your configuration: +If you have an existing Prisma project, Studio can read your database connection configuration: -- A `prisma/schema.prisma` file with at least one model defined -- A `prisma.config.ts` configuration file +- A `prisma.config.ts` configuration file with database connection details - A configured database connection +:::note + +The new Studio does not read the `prisma/schema.prisma` file. It introspects your database directly to understand the schema structure. + +::: + ## Getting started ### Standalone usage (without Prisma ORM) @@ -49,7 +56,7 @@ If you have a Prisma project, run the following command in your project director npx prisma studio --config ./prisma.config.ts ``` -Both commands start a local web server (default port `5555`) and open Prisma Studio in your browser. Studio connects to your database and introspects the schema to provide a visual interface for your data. +Both commands start a local web server (default port `5555`) and open Prisma Studio in your browser. Studio connects directly to your database and introspects the schema in real-time to provide a visual interface for your data—no Prisma schema file required. ## Core features diff --git a/content/250-postgres/300-database/675-prisma-studio/index.mdx b/content/250-postgres/300-database/675-prisma-studio/index.mdx index afc7e9f505..c8f27f91ef 100644 --- a/content/250-postgres/300-database/675-prisma-studio/index.mdx +++ b/content/250-postgres/300-database/675-prisma-studio/index.mdx @@ -10,11 +10,13 @@ toc: true Prisma Postgres comes with Prisma Studio built-in. You can use it in several ways: -- Run `npx prisma studio` to use Studio locally on your machine (also works with any other database via Prisma ORM) +- Run `npx prisma studio --url "postgresql://user:password@localhost:5432/dbname"` to use Studio locally on your machine (also works with any other database) - Find the **Studio** tab in your project in the [Prisma Console](https://console.prisma.io) to use Studio online - Install the [Prisma VS Code extension](https://marketplace.visualstudio.com/items?itemName=Prisma.prisma) to use Studio directly in VS Code - [Embed Prisma Studio](/postgres/database/prisma-studio/embedding-studio) in your own app (e.g. as an admin dashboard) :::note -If you want to **use Prisma Studio with another database than Prisma Postgres**, check the docs [here](/orm/tools/prisma-studio). + +If you want to use Prisma Studio with another database than Prisma Postgres, check the docs [here](/orm/tools/prisma-studio). + ::: \ No newline at end of file