Skip to content

Commit bc16662

Browse files
ankur-archclaude
andcommitted
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>
1 parent 40a4499 commit bc16662

3 files changed

Lines changed: 67 additions & 36 deletions

File tree

apps/docs/content/docs/(index)/getting-started.mdx

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,35 @@
11
---
22
title: Choose a setup path
3-
description: Choose the fastest path to start using Prisma ORM or 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.
44
url: /getting-started
55
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.
77
---
88

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.
1010

1111
## Choose your path
1212

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+
1319
### Start a new project
1420

21+
Use this path if you are creating a new app and want to set up Prisma from the beginning.
22+
1523
- [Quickstart with Prisma Postgres](/prisma-orm/quickstart/prisma-postgres) for the fastest end-to-end path with a managed PostgreSQL database
1624
- [Quickstart with PostgreSQL](/prisma-orm/quickstart/postgresql) if you want to work with PostgreSQL
1725
- [Quickstart with SQLite](/prisma-orm/quickstart/sqlite) for a lightweight local setup
1826
- [Quickstart with MySQL](/prisma-orm/quickstart/mysql) if your application uses MySQL
1927
- [Quickstart with MongoDB](/prisma-orm/quickstart/mongodb) if your application uses MongoDB
2028

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-
2629
### Add Prisma to an existing project
2730

31+
Use this path if you already have an application or database and want to add Prisma ORM.
32+
2833
- [Add Prisma ORM to an existing PostgreSQL project](/prisma-orm/add-to-existing-project/postgresql)
2934
- [Add Prisma ORM to an existing MySQL project](/prisma-orm/add-to-existing-project/mysql)
3035
- [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
3338

3439
## What you will do
3540

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:
3742

3843
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.
4249

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:
4451

4552
1. Sign in with `npx @prisma/cli@latest auth login`.
4653
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.
4957

5058
## Next steps
5159

Lines changed: 36 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,60 @@
11
---
22
title: Introduction to Prisma
3-
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.
44
url: /
55
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."
77
---
8+
89
[**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.
910

1011
```npm
11-
npx prisma init
12+
npx prisma@latest init
1213
```
1314

14-
1515
[**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).
1616

1717
```npm
18-
npx create-db
18+
npx create-db@latest
1919
```
2020

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.
2322

2423
```npm
2524
npx @prisma/cli@latest app deploy
2625
```
2726

28-
2927
<Cards>
30-
<Card href="/prisma-compute/deploy" title="Use Prisma Compute" icon={<Rocket className="text-primary" />}>
31-
**Ready to deploy?** Run your app next to your database, with a live preview for every branch.
28+
<Card
29+
href="/prisma-compute/deploy"
30+
title="Use Prisma Compute"
31+
icon={<Rocket className="text-primary" />}
32+
>
33+
Deploy and run your TypeScript app next to your database, with a live
34+
preview for every branch.
3235
</Card>
33-
<Card href="/prisma-orm/quickstart/prisma-postgres" title="Use Prisma Postgres" icon={<div className="text-primary"><svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="159" height="195" viewBox="0 0 640 640" fill="none"><path d="M355.2 85C348.2 72.1 334.7 64 320 64C305.3 64 291.8 72.1 284.8 85L209.7 224L430.2 224L355.1 85zM123.3 384L516.6 384L456.1 272L183.7 272L123.2 384zM97.4 432L68.8 485C62.1 497.4 62.4 512.4 69.6 524.5C76.8 536.6 89.9 544 104 544L536 544C550.1 544 563.1 536.6 570.4 524.5C577.7 512.4 577.9 497.4 571.2 485L542.6 432L97.4 432z" fill="currentColor"/></svg></div>
34-
}>
35-
**Need a database?** Get started with your favorite framework and Prisma Postgres.
36+
<Card
37+
href="/prisma-orm/quickstart/prisma-postgres"
38+
title="Use Prisma Postgres"
39+
icon={
40+
<div className="text-primary">
41+
<svg
42+
aria-hidden="true"
43+
xmlns="http://www.w3.org/2000/svg"
44+
width="159"
45+
height="195"
46+
viewBox="0 0 640 640"
47+
fill="none"
48+
>
49+
<path
50+
d="M355.2 85C348.2 72.1 334.7 64 320 64C305.3 64 291.8 72.1 284.8 85L209.7 224L430.2 224L355.1 85zM123.3 384L516.6 384L456.1 272L183.7 272L123.2 384zM97.4 432L68.8 485C62.1 497.4 62.4 512.4 69.6 524.5C76.8 536.6 89.9 544 104 544L536 544C550.1 544 563.1 536.6 570.4 524.5C577.7 512.4 577.9 497.4 571.2 485L542.6 432L97.4 432z"
51+
fill="currentColor"
52+
/>
53+
</svg>
54+
</div>
55+
}
56+
>
57+
Get started with your favorite framework and Prisma Postgres as the
58+
database.
3659
</Card>
3760
</Cards>

apps/docs/content/docs/compute/index.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
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."
44
url: /compute
55
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.
88
---
99

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.
1111

1212
:::info[Public Beta]
1313

@@ -17,25 +17,25 @@ Prisma Compute is in [Public Beta](/console/more/feature-maturity#public-beta) a
1717

1818
## Get started
1919

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.
2121

2222
<Cards>
2323
<Card href="/prisma-compute/deploy" title="Deploy your first app">
2424
The quickstart: sign in, deploy, verify, and connect GitHub.
2525
</Card>
2626
</Cards>
2727

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.
2929

3030
## The model
3131

3232
Compute organizes everything into a few resources:
3333

3434
- 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.
3636
- An **app** is an HTTP service, such as a frontend or backend, and can have multiple **deployments**.
3737

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.
3939

4040
- **Production**: the default Git branch (e.g., `main`) is your production branch, with its own resources and environment variables.
4141
- **Preview**: every other branch is a preview branch, with its own isolated resources and environment variables scoped to **preview**.

0 commit comments

Comments
 (0)