You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: align getting-started and overview entry points with Compute
Reorganize the getting-started page around what you want to do first
(deploy, start a new project, add to an existing project), refresh the
landing page copy and cards, and tighten the Compute overview model
description.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: apps/docs/content/docs/(index)/getting-started.mdx
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,30 +1,35 @@
1
1
---
2
2
title: Choose a setup path
3
-
description: Choose the fastest path to start using Prisma ORMor Prisma Postgres in a new or existing project.
3
+
description: Choose the fastest path to start using Prisma ORM, Prisma Postgres, or Prisma Compute in a new or existing TypeScript project.
4
4
url: /getting-started
5
5
metaTitle: Prisma getting started
6
-
metaDescription: Choose a Prisma quickstart for new or existing projects and get from schema to first query quickly.
6
+
metaDescription: Choose the fastest path to start using Prisma ORM, Prisma Postgres, or Prisma Compute in a new or existing TypeScript project.
7
7
---
8
8
9
-
Prisma gives you a few good starting points depending on whether you need a database, already have one, want the smallest possible local setup, or are ready to deploy your app.
9
+
Prisma gives you a few starting points depending on what you want to do first: deploy an app, create a database, use Prisma ORM locally, or add Prisma to an existing project.
10
10
11
11
## Choose your path
12
12
13
+
### Deploy a full-stack app with a database
14
+
15
+
Use this path if you want to deploy a TypeScript app with Prisma Compute and run it alongside Prisma Postgres.
16
+
17
+
-[Deploy your first app](/prisma-compute/deploy) on [Prisma Compute](/compute), currently in Public Beta, to run it next to your Prisma Postgres database
18
+
13
19
### Start a new project
14
20
21
+
Use this path if you are creating a new app and want to set up Prisma from the beginning.
22
+
15
23
-[Quickstart with Prisma Postgres](/prisma-orm/quickstart/prisma-postgres) for the fastest end-to-end path with a managed PostgreSQL database
16
24
-[Quickstart with PostgreSQL](/prisma-orm/quickstart/postgresql) if you want to work with PostgreSQL
17
25
-[Quickstart with SQLite](/prisma-orm/quickstart/sqlite) for a lightweight local setup
18
26
-[Quickstart with MySQL](/prisma-orm/quickstart/mysql) if your application uses MySQL
19
27
-[Quickstart with MongoDB](/prisma-orm/quickstart/mongodb) if your application uses MongoDB
20
28
21
-
### Deploy your app
22
-
23
-
-[Deploy your first app](/prisma-compute/deploy) on [Prisma Compute](/compute), currently in Public Beta, to run it next to your Prisma Postgres database
24
-
-[Set environment variables](/compute/environment-variables) to connect your deployed app to a database
25
-
26
29
### Add Prisma to an existing project
27
30
31
+
Use this path if you already have an application or database and want to add Prisma ORM.
32
+
28
33
-[Add Prisma ORM to an existing PostgreSQL project](/prisma-orm/add-to-existing-project/postgresql)
29
34
-[Add Prisma ORM to an existing MySQL project](/prisma-orm/add-to-existing-project/mysql)
30
35
-[Add Prisma ORM to an existing SQLite project](/prisma-orm/add-to-existing-project/sqlite)
@@ -33,19 +38,22 @@ Prisma gives you a few good starting points depending on whether you need a data
33
38
34
39
## What you will do
35
40
36
-
No matter which guide you choose, the flow is usually the same:
41
+
Most Prisma ORM and Prisma Postgres guides follow the same basic flow:
37
42
38
43
1. Define a database connection and data model in your [Prisma schema](/orm/prisma-schema/overview).
39
-
2. Install Prisma CLI and [Prisma Client](/orm/prisma-client).
40
-
3. Run `prisma generate` to create a type-safe client for your schema.
41
-
4. Create or introspect your database, then start sending queries from your application.
44
+
2. Set up your database, either with [Prisma Postgres](/postgres) or another supported database.
45
+
3. Install Prisma CLI and [Prisma Client](/orm/prisma-client).
46
+
4. Run `prisma generate` to create a type-safe client for your schema.
47
+
5. Create or introspect your database.
48
+
6. Start sending queries from your application.
42
49
43
-
If you're deploying to [Prisma Compute](/compute), the equivalent flow is:
50
+
Then you can deploy your app to [Prisma Compute](/compute). The flow is:
44
51
45
52
1. Sign in with `npx @prisma/cli@latest auth login`.
46
53
2. Run `npx @prisma/cli@latest app deploy` from your app directory to get a live URL.
47
-
3. Set your database connection string and other config as [environment variables](/compute/environment-variables).
48
-
4. Redeploy to apply them, then keep shipping from the CLI or [connect GitHub](/compute/github) to deploy on push.
54
+
3. Connect your app to [Prisma Postgres](/postgres) or another database with [environment variables](/compute/environment-variables).
55
+
4. Redeploy to apply the environment variables.
56
+
5. Keep deploying from the CLI, or [connect GitHub](/compute/github) to deploy on push.
description: Build data-driven applications with ease using Prisma ORM and Prisma Postgres
3
+
description: Build, deploy, and iterate on TypeScript applications with Prisma ORM, Prisma Postgres, and Prisma Compute.
4
4
url: /
5
5
metaTitle: Get started with Prisma
6
-
metaDescription: 'Build data-driven applications with ease using Prisma ORM, add connection pooling with Prisma Postgres.'
6
+
metaDescription: "Build, deploy, and iterate on TypeScript applications with Prisma ORM, Prisma Postgres, and Prisma Compute."
7
7
---
8
+
8
9
[**Prisma ORM**](/orm) is an open-source ORM that provides fast, type-safe access to Postgres, MySQL, SQLite, and other databases, and runs smoothly across Node.js, Bun, and Deno.
9
10
10
11
```npm
11
-
npx prisma init
12
+
npx prisma@latest init
12
13
```
13
14
14
-
15
15
[**Prisma Postgres**](/postgres) is a fully managed PostgreSQL database that scales to zero, integrates with [Prisma ORM](/orm) and [Prisma Studio](/studio), and includes a [generous free tier](https://www.prisma.io/pricing).
16
16
17
17
```npm
18
-
npx create-db
18
+
npx create-db@latest
19
19
```
20
20
21
-
22
-
[**Prisma Compute**](/compute) runs your app next to your Prisma Postgres database, currently in [Public Beta](/console/more/feature-maturity#public-beta). Deploy Next.js, Hono, TanStack Start, and Bun apps, with an isolated preview for every branch.
21
+
[**Prisma Compute**](/compute) is TypeScript app hosting for running your app next to your Prisma Postgres database. It is currently in [Public Beta](/console/more/feature-maturity#public-beta). Deploy Next.js, Hono, TanStack Start, and Bun apps, with an isolated preview for every branch.
Copy file name to clipboardExpand all lines: apps/docs/content/docs/compute/index.mdx
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
---
2
2
title: Prisma Compute
3
-
description: "Deploy and run your TypeScript app on the same platform as Prisma Postgres, with your schema, database, hosting, and previews managed together."
3
+
description: "Deploy TypeScript apps alongside Prisma Postgres, with hosting, database branches, and previews managed together."
4
4
url: /compute
5
5
badge: beta
6
-
metaTitle: Overview | Prisma Compute
7
-
metaDescription: Learn what Prisma Compute is, how it runs your app alongside Prisma Postgres, and how to deploy your first app.
6
+
metaTitle: Prisma Compute | TypeScript app hosting for Prisma Postgres
7
+
metaDescription: Learn how Prisma Compute deploys TypeScript apps alongside Prisma Postgres, with isolated branch previews, database branches, and CLI-first workflows.
8
8
---
9
9
10
-
Prisma Compute deploys and runs your TypeScript app on the same platform as[Prisma Postgres](/postgres). You model your data with [Prisma ORM](/orm), store it in Prisma Postgres, and deploy your app to Prisma Compute, so your schema, database, and hosting are managed together in one sandbox.
10
+
Prisma Compute is TypeScript app hosting built to run alongside[Prisma Postgres](/postgres). You model your data with [Prisma ORM](/orm), store it in Prisma Postgres, and deploy your app with Prisma Compute, so your schema, database, hosting, and branch previews work together in one Prisma project.
11
11
12
12
:::info[Public Beta]
13
13
@@ -17,25 +17,25 @@ Prisma Compute is in [Public Beta](/console/more/feature-maturity#public-beta) a
17
17
18
18
## Get started
19
19
20
-
The best way to understand Compute is to deploy an app. The quickstart gets a TypeScript app to a live URL in a few minutes, then connects GitHub so every push deploys automatically.
20
+
The best way to understand Compute is to deploy an app. The quickstart takes a TypeScript app to a live URL in a few minutes, then connects GitHub so every push can deploy automatically.
21
21
22
22
<Cards>
23
23
<Cardhref="/prisma-compute/deploy"title="Deploy your first app">
24
24
The quickstart: sign in, deploy, verify, and connect GitHub.
25
25
</Card>
26
26
</Cards>
27
27
28
-
To learn how Compute works, [the model](#the-model) below shows how each branch gets an isolated copy of your app and database, so previews never touch production.
28
+
To learn how Compute works, [the model](#the-model) below shows how each branch gets isolated app and database resources, so preview work never touches production.
29
29
30
30
## The model
31
31
32
32
Compute organizes everything into a few resources:
33
33
34
34
- A **project** groups one product or codebase.
35
-
- A **branch** maps to a Git branch in the linked repository, and gets its own isolated app and deployments.
35
+
- A **branch** maps to a Git branch in the linked repository, and gets its own isolated app, environment variables, and deployments.
36
36
- An **app** is an HTTP service, such as a frontend or backend, and can have multiple **deployments**.
37
37
38
-
The branch is the idea that ties Compute together, because each branch owns its own app, database, and URL. When you create a branch, Compute provisions a full copy of that infrastructure, so preview work runs in complete isolation and never touches production.
38
+
The branch is the concept that ties Compute together. Each branch owns its own app, database, URL, and environment variables. When you create a branch, Compute provisions isolated resources for that branch, so you can test changes in preview without affecting production.
39
39
40
40
-**Production**: the default Git branch (e.g., `main`) is your production branch, with its own resources and environment variables.
41
41
-**Preview**: every other branch is a preview branch, with its own isolated resources and environment variables scoped to **preview**.
0 commit comments