From c9067b1858af1cb27121cb621cabd85f1d5c61ef Mon Sep 17 00:00:00 2001 From: Gregory Boch Date: Wed, 28 Oct 2026 17:16:45 +0100 Subject: [PATCH 1/5] docs: agents give the user the create-db claim URL every time A create-db database is deleted after 24 hours unless someone opens its claim URL. The AI prompts had agents run npx create-db without ever mentioning the claim URL, and the create-db page and the two agent blog posts told agents to show it only "if the work should be kept", a call the agent makes on its own. - AI prompts (Next.js, Nuxt, Astro): give the user the claim URL that npx create-db printed, with the 24-hour deadline. - npx-create-db page and its AGENTS.md block: show the claimUrl and the deletion time every time. - Blog posts give-your-agent-a-database and agents-md-for-databases: same rule in the agent loop and the AGENTS.md snippets. Co-Authored-By: Claude Opus 5.5 --- apps/blog/content/blog/agents-md-for-databases/index.mdx | 2 +- apps/blog/content/blog/give-your-agent-a-database/index.mdx | 4 ++-- apps/docs/content/docs/ai/prompts/astro.mdx | 2 +- apps/docs/content/docs/ai/prompts/nextjs.mdx | 6 ++++-- apps/docs/content/docs/ai/prompts/nuxt.mdx | 6 ++++-- apps/docs/content/docs/postgres/npx-create-db.mdx | 4 ++-- 6 files changed, 14 insertions(+), 10 deletions(-) diff --git a/apps/blog/content/blog/agents-md-for-databases/index.mdx b/apps/blog/content/blog/agents-md-for-databases/index.mdx index a2ad478b3fd..e8e41143f16 100644 --- a/apps/blog/content/blog/agents-md-for-databases/index.mdx +++ b/apps/blog/content/blog/agents-md-for-databases/index.mdx @@ -81,7 +81,7 @@ Here is the full section, ready to paste into your AGENTS.md: - When a task needs a database for testing or prototyping, run `npx create-db@latest --json` and use the `connectionString` field as `DATABASE_URL` for that task. The database is temporary and deletes - itself after 24 hours. If the work should be kept, show me the `claimUrl`. + itself after 24 hours unless claimed. Always show me the `claimUrl`. - Never run `prisma migrate reset`, drop a schema or table, or delete data without my explicit confirmation. The only exception is a throwaway database you provisioned for the current task; even there, diff --git a/apps/blog/content/blog/give-your-agent-a-database/index.mdx b/apps/blog/content/blog/give-your-agent-a-database/index.mdx index 78eb74f61d2..c3380202415 100644 --- a/apps/blog/content/blog/give-your-agent-a-database/index.mdx +++ b/apps/blog/content/blog/give-your-agent-a-database/index.mdx @@ -95,7 +95,7 @@ The agent's loop is three steps: 1. Run `npx create-db@latest --json` and parse the output. 2. Set `DATABASE_URL` to `connectionString` and run migrations, seeds, and tests against it. -3. When the task ends, do nothing. The database deletes itself at `deletionDate`. If the work should be kept, surface `claimUrl` to the human. +3. When the task ends, show the human `claimUrl` and `deletionDate`, then do nothing else. The database deletes itself at `deletionDate` unless the human claims it. You can pin a region with `--region` (`ap-southeast-1`, `ap-northeast-1`, `eu-central-1`, `eu-west-3`, `us-east-1`, or `us-west-1`) or pick one interactively with `-i`. The [create-db docs](https://www.prisma.io/docs/postgres/npx-create-db) list every flag. @@ -132,7 +132,7 @@ When you need a database for testing or prototyping, run: Parse the JSON output and use `connectionString` as `DATABASE_URL`. The database is temporary and deletes itself after 24 hours. -If the work should be kept, show me the `claimUrl` so I can claim the database. +Always show me the `claimUrl` so I can claim the database before it is deleted. ``` If your agent speaks MCP, the [Prisma MCP server](https://www.prisma.io/docs/ai/tools/mcp-server) goes further: it can provision databases, run SQL, introspect schemas, and [search the Prisma docs](/search-prisma-docs-from-your-coding-agent) through one endpoint. `create-db` is the zero-config entry point; the MCP server is the full toolbox. diff --git a/apps/docs/content/docs/ai/prompts/astro.mdx b/apps/docs/content/docs/ai/prompts/astro.mdx index 6b28b609157..fb70f94d4f0 100644 --- a/apps/docs/content/docs/ai/prompts/astro.mdx +++ b/apps/docs/content/docs/ai/prompts/astro.mdx @@ -82,7 +82,7 @@ export default prisma 5. You MUST wrap all database calls in try-catch blocks 6. You MUST import from `'../generated/prisma/client'` (not `'@prisma/client'`) 7. You MUST use `import.meta.env.DATABASE_URL` in Astro (not `process.env`) -8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db` and update `.env` with the returned `postgres://...` value +8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db`, update `.env` with the returned `postgres://...` value, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) ## CORRECT INSTALLATION diff --git a/apps/docs/content/docs/ai/prompts/nextjs.mdx b/apps/docs/content/docs/ai/prompts/nextjs.mdx index 4d0252c6cee..823bf786e27 100644 --- a/apps/docs/content/docs/ai/prompts/nextjs.mdx +++ b/apps/docs/content/docs/ai/prompts/nextjs.mdx @@ -154,7 +154,7 @@ export default prisma 10. You MUST create a test script at `scripts/test-database.ts` to verify setup 11. You MUST NOT include `url` in the datasource block of `schema.prisma` 12. You MUST NOT include `engine` property in `prisma.config.ts` -13. You MUST use `npx prisma init --output ../app/generated/prisma` to scaffold Prisma, then `npx create-db` to create a real cloud database +13. You MUST use `npx prisma init --output ../app/generated/prisma` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) 14. You MUST use standard TCP URLs (`postgres://...`) in .env 15. You MUST NOT use `accelerateUrl` or `withAccelerate` @@ -193,7 +193,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -456,6 +456,8 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** + If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. + 4. **Update `prisma/schema.prisma`** - Add the User model (generator and datasource are already configured): ```prisma diff --git a/apps/docs/content/docs/ai/prompts/nuxt.mdx b/apps/docs/content/docs/ai/prompts/nuxt.mdx index 656efb64aa6..d1032bd94ef 100644 --- a/apps/docs/content/docs/ai/prompts/nuxt.mdx +++ b/apps/docs/content/docs/ai/prompts/nuxt.mdx @@ -159,7 +159,7 @@ export { prisma } 10. You MUST create a test script at `scripts/test-database.ts` to verify setup 11. You MUST NOT include `url` in the datasource block of `schema.prisma` 12. You MUST NOT include `engine` property in `prisma.config.ts` -13. You MUST use `npx prisma init --output ./generated` to scaffold Prisma, then `npx create-db` to create a real cloud database +13. You MUST use `npx prisma init --output ./generated` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) 14. You MUST use standard TCP URLs (`postgres://...`) in .env 15. You MUST NOT use `accelerateUrl` or `withAccelerate` 16. You MUST install `pg` and `@types/pg` as dependencies @@ -199,7 +199,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -468,6 +468,8 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** + If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. + 5. **Update `prisma/schema.prisma`** — Add the User and Post models (generator and datasource are already configured): ```prisma diff --git a/apps/docs/content/docs/postgres/npx-create-db.mdx b/apps/docs/content/docs/postgres/npx-create-db.mdx index e8ba05b8792..aac4ea19d1e 100644 --- a/apps/docs/content/docs/postgres/npx-create-db.mdx +++ b/apps/docs/content/docs/postgres/npx-create-db.mdx @@ -161,7 +161,7 @@ npx create-db@latest --json --ttl 1h When an agent creates databases: - Create one database per task, not one per test run. Database creation is rate-limited per IP address. -- When the work should be kept, show the human the `claimUrl`. Claiming needs a Prisma account, so a person has to do it. +- Show the human the `claimUrl` and the `deletionDate` every time. The database is deleted unless someone claims it, and claiming needs a Prisma account, so a person has to do it. - Treat the database as disposable until it is claimed: it is deleted when its time to live runs out. To make this the agent's default, add a short block to your project's `AGENTS.md`: @@ -171,7 +171,7 @@ To make this the agent's default, add a short block to your project's `AGENTS.md - For a task that needs a scratch database, run `npx create-db@latest --json` and use `connectionString` as `DATABASE_URL` for that task only, never in the shared `.env`. - Create one database per task. It is deleted after 24 hours unless claimed. -- If the work should be kept, show me the `claimUrl`. Claiming needs my Prisma account. +- Every time you create one, show me the `claimUrl` and when it is deleted. Claiming needs my Prisma account. ``` Claude Code doesn't always read `AGENTS.md`, for example when your project also has a `CLAUDE.md`. Add the line `@AGENTS.md` to a `CLAUDE.md` next to your `AGENTS.md` so Claude Code imports these rules. From 6f4d5fe824eb4e0e3b9679e1108a1a72ce67abca Mon Sep 17 00:00:00 2001 From: Gregory Boch Date: Thu, 29 Oct 2026 15:41:00 +0100 Subject: [PATCH 2/5] docs: claim URL when the user ran create-db; --env and --quiet print it - AI prompts (Next.js, Nuxt): if the user ran `npx create-db`, remind them to open the claim URL in its output. - npx-create-db: create-db 1.3.0 prints the claim URL and deletion time with --env, and on stderr with --quiet; --json adds nextStep. Update the --env sentence, the agent rule, the JSON example and the flag table. Co-Authored-By: Claude Opus 5.5 --- apps/docs/content/docs/ai/prompts/nextjs.mdx | 4 ++-- apps/docs/content/docs/ai/prompts/nuxt.mdx | 4 ++-- apps/docs/content/docs/postgres/npx-create-db.mdx | 11 ++++++----- 3 files changed, 10 insertions(+), 9 deletions(-) diff --git a/apps/docs/content/docs/ai/prompts/nextjs.mdx b/apps/docs/content/docs/ai/prompts/nextjs.mdx index 823bf786e27..c840c2cc0fd 100644 --- a/apps/docs/content/docs/ai/prompts/nextjs.mdx +++ b/apps/docs/content/docs/ai/prompts/nextjs.mdx @@ -193,7 +193,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -456,7 +456,7 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** - If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. + If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. 4. **Update `prisma/schema.prisma`** - Add the User model (generator and datasource are already configured): diff --git a/apps/docs/content/docs/ai/prompts/nuxt.mdx b/apps/docs/content/docs/ai/prompts/nuxt.mdx index d1032bd94ef..a69293a338c 100644 --- a/apps/docs/content/docs/ai/prompts/nuxt.mdx +++ b/apps/docs/content/docs/ai/prompts/nuxt.mdx @@ -199,7 +199,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -468,7 +468,7 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** - If you ran `npx create-db` yourself, give the user the claim URL it printed. The database is deleted after 24 hours unless they claim it with a free Prisma account. + If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. 5. **Update `prisma/schema.prisma`** — Add the User and Post models (generator and datasource are already configured): diff --git a/apps/docs/content/docs/postgres/npx-create-db.mdx b/apps/docs/content/docs/postgres/npx-create-db.mdx index aac4ea19d1e..4caee480091 100644 --- a/apps/docs/content/docs/postgres/npx-create-db.mdx +++ b/apps/docs/content/docs/postgres/npx-create-db.mdx @@ -118,7 +118,7 @@ Once you have the output, take the connection string and add it to your `.env` f DATABASE_URL="postgres://:@db.prisma.io:5432/postgres?sslmode=require" ``` -If you don't have a `.env` file yet, you can skip the copy step by creating the database with `npx create-db@latest --env .env` instead. This creates the file with `DATABASE_URL` and `CLAIM_URL` and prints only a confirmation, so the claim URL is in `CLAIM_URL` rather than in the terminal. On a file that already exists, `--env` appends both lines without removing an existing `DATABASE_URL`, so delete the old line yourself. +If you don't have a `.env` file yet, you can skip the copy step by creating the database with `npx create-db@latest --env .env` instead. This creates the file with `DATABASE_URL` and `CLAIM_URL`, then prints a confirmation and the claim URL with its deletion time. On a file that already exists, `--env` appends both lines without removing an existing `DATABASE_URL`, so delete the old line yourself. You can now follow the [Prisma Postgres quickstart guide](/v7/prisma-orm/quickstart/prisma-postgres) to connect your Prisma project to this database. @@ -140,7 +140,8 @@ npx create-db@latest --json "deletionDate": "2026-10-13T08:44:59.650Z", "region": "eu-west-3", "name": "2026-10-12T08:44:55.985Z", - "projectId": "proj_..." + "projectId": "proj_...", + "nextStep": "The database is deleted at 2026-10-13T08:44:59.650Z unless the user claims it, which keeps it for free. Give the user this claim URL: https://create-db.prisma.io/claim?projectID=proj_...&utm_source=create-db&utm_medium=cli" } ``` @@ -161,7 +162,7 @@ npx create-db@latest --json --ttl 1h When an agent creates databases: - Create one database per task, not one per test run. Database creation is rate-limited per IP address. -- Show the human the `claimUrl` and the `deletionDate` every time. The database is deleted unless someone claims it, and claiming needs a Prisma account, so a person has to do it. +- Show the human the claim URL and the deletion time every time. The database is deleted unless someone claims it, and claiming needs a Prisma account, so a person has to do it. `--json` returns them as `claimUrl` and `deletionDate`, with a `nextStep` that says the same; `--env` and `--quiet` print them in a claim line (`--quiet` on stderr). - Treat the database as disposable until it is claimed: it is deleted when its time to live runs out. To make this the agent's default, add a short block to your project's `AGENTS.md`: @@ -218,10 +219,10 @@ Here are the CLI flags for the `npx create-db` command: | `--region ` | `-r` | AWS region for the database.
**Available regions:** `ap-southeast-1`, `ap-northeast-1`, `eu-central-1`, `eu-west-3`, `us-east-1`, `us-west-1`. Without it, `create-db` picks the region closest to you (fallback `us-east-1`). | | `--interactive` | `-i` | Run in interactive mode to select a region. | | `--json` | `-j` | Output machine-readable JSON. | -| `--env ` | `-e` | Write `DATABASE_URL` and `CLAIM_URL` to the specified `.env` file. If the file exists, the two lines are appended. | +| `--env ` | `-e` | Write `DATABASE_URL` and `CLAIM_URL` to the specified `.env` file and print the claim URL. If the file exists, the two lines are appended. | | `--ttl ` | `-t` | Auto-delete after `30m`, or `1h` to `24h`. The default and maximum is `24h`. | | `--copy` | `-c` | Copy the connection string to your clipboard. | -| `--quiet` | `-q` | Only output the connection string. | +| `--quiet` | `-q` | Only output the connection string on stdout. The claim URL and deletion time go to stderr. | | `--open` | `-o` | Open the claim URL in your browser. | | `--help` | `-h` | Display help for the command. | From 697d18bdb42a0e1b3a85455b300471d24ba3f9c3 Mon Sep 17 00:00:00 2001 From: Gregory Boch Date: Thu, 29 Oct 2026 16:06:41 +0100 Subject: [PATCH 3/5] docs: show the create-db deletion time with the claim URL everywhere - AI prompts (Next.js, Nuxt, Astro): the agent passes on the claim URL and the deletion time create-db prints; if the user ran it, it reminds them to open the URL and check the time. - npx-create-db: the --env flag row says it prints the deletion time too. - Blog AGENTS.md snippets ask for `deletionDate` as well as `claimUrl`. Co-Authored-By: Claude Opus 5.5 --- apps/blog/content/blog/agents-md-for-databases/index.mdx | 3 ++- apps/blog/content/blog/give-your-agent-a-database/index.mdx | 2 +- apps/docs/content/docs/ai/prompts/astro.mdx | 2 +- apps/docs/content/docs/ai/prompts/nextjs.mdx | 6 +++--- apps/docs/content/docs/ai/prompts/nuxt.mdx | 6 +++--- apps/docs/content/docs/postgres/npx-create-db.mdx | 2 +- 6 files changed, 11 insertions(+), 10 deletions(-) diff --git a/apps/blog/content/blog/agents-md-for-databases/index.mdx b/apps/blog/content/blog/agents-md-for-databases/index.mdx index e8e41143f16..caa00f337de 100644 --- a/apps/blog/content/blog/agents-md-for-databases/index.mdx +++ b/apps/blog/content/blog/agents-md-for-databases/index.mdx @@ -81,7 +81,8 @@ Here is the full section, ready to paste into your AGENTS.md: - When a task needs a database for testing or prototyping, run `npx create-db@latest --json` and use the `connectionString` field as `DATABASE_URL` for that task. The database is temporary and deletes - itself after 24 hours unless claimed. Always show me the `claimUrl`. + itself after 24 hours unless claimed. Always show me the `claimUrl` + and `deletionDate`. - Never run `prisma migrate reset`, drop a schema or table, or delete data without my explicit confirmation. The only exception is a throwaway database you provisioned for the current task; even there, diff --git a/apps/blog/content/blog/give-your-agent-a-database/index.mdx b/apps/blog/content/blog/give-your-agent-a-database/index.mdx index c3380202415..131cf571746 100644 --- a/apps/blog/content/blog/give-your-agent-a-database/index.mdx +++ b/apps/blog/content/blog/give-your-agent-a-database/index.mdx @@ -132,7 +132,7 @@ When you need a database for testing or prototyping, run: Parse the JSON output and use `connectionString` as `DATABASE_URL`. The database is temporary and deletes itself after 24 hours. -Always show me the `claimUrl` so I can claim the database before it is deleted. +Always show me the `claimUrl` and `deletionDate` so I can claim the database before it is deleted. ``` If your agent speaks MCP, the [Prisma MCP server](https://www.prisma.io/docs/ai/tools/mcp-server) goes further: it can provision databases, run SQL, introspect schemas, and [search the Prisma docs](/search-prisma-docs-from-your-coding-agent) through one endpoint. `create-db` is the zero-config entry point; the MCP server is the full toolbox. diff --git a/apps/docs/content/docs/ai/prompts/astro.mdx b/apps/docs/content/docs/ai/prompts/astro.mdx index fb70f94d4f0..e8026e007d7 100644 --- a/apps/docs/content/docs/ai/prompts/astro.mdx +++ b/apps/docs/content/docs/ai/prompts/astro.mdx @@ -82,7 +82,7 @@ export default prisma 5. You MUST wrap all database calls in try-catch blocks 6. You MUST import from `'../generated/prisma/client'` (not `'@prisma/client'`) 7. You MUST use `import.meta.env.DATABASE_URL` in Astro (not `process.env`) -8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db`, update `.env` with the returned `postgres://...` value, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) +8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db`, update `.env` with the returned `postgres://...` value, and give the user the claim URL and deletion time it prints (the database is deleted after 24 hours unless claimed) ## CORRECT INSTALLATION diff --git a/apps/docs/content/docs/ai/prompts/nextjs.mdx b/apps/docs/content/docs/ai/prompts/nextjs.mdx index c840c2cc0fd..0e352193d40 100644 --- a/apps/docs/content/docs/ai/prompts/nextjs.mdx +++ b/apps/docs/content/docs/ai/prompts/nextjs.mdx @@ -154,7 +154,7 @@ export default prisma 10. You MUST create a test script at `scripts/test-database.ts` to verify setup 11. You MUST NOT include `url` in the datasource block of `schema.prisma` 12. You MUST NOT include `engine` property in `prisma.config.ts` -13. You MUST use `npx prisma init --output ../app/generated/prisma` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) +13. You MUST use `npx prisma init --output ../app/generated/prisma` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL and deletion time it prints (the database is deleted after 24 hours unless claimed) 14. You MUST use standard TCP URLs (`postgres://...`) in .env 15. You MUST NOT use `accelerateUrl` or `withAccelerate` @@ -193,7 +193,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL and deletion time it printed. If the user ran it, remind them to open the claim URL and check the deletion time in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -456,7 +456,7 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** - If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. + If you ran `npx create-db` yourself, give the user the claim URL and deletion time it printed. If the user ran it, remind them to open the claim URL and check the deletion time in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. 4. **Update `prisma/schema.prisma`** - Add the User model (generator and datasource are already configured): diff --git a/apps/docs/content/docs/ai/prompts/nuxt.mdx b/apps/docs/content/docs/ai/prompts/nuxt.mdx index a69293a338c..8d0fb9c4d92 100644 --- a/apps/docs/content/docs/ai/prompts/nuxt.mdx +++ b/apps/docs/content/docs/ai/prompts/nuxt.mdx @@ -159,7 +159,7 @@ export { prisma } 10. You MUST create a test script at `scripts/test-database.ts` to verify setup 11. You MUST NOT include `url` in the datasource block of `schema.prisma` 12. You MUST NOT include `engine` property in `prisma.config.ts` -13. You MUST use `npx prisma init --output ./generated` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL it prints (the database is deleted after 24 hours unless claimed) +13. You MUST use `npx prisma init --output ./generated` to scaffold Prisma, then `npx create-db` to create a real cloud database, and give the user the claim URL and deletion time it prints (the database is deleted after 24 hours unless claimed) 14. You MUST use standard TCP URLs (`postgres://...`) in .env 15. You MUST NOT use `accelerateUrl` or `withAccelerate` 16. You MUST install `pg` and `@types/pg` as dependencies @@ -199,7 +199,7 @@ This step: - Generates `.env` with a local `DATABASE_URL` - Requires `npx create-db` if you want a real Prisma Postgres database -**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. +**IMPORTANT**: After `npx create-db`, replace the generated `DATABASE_URL` in `.env` with the returned `postgres://...` connection string. If you ran `npx create-db` yourself, give the user the claim URL and deletion time it printed. If the user ran it, remind them to open the claim URL and check the deletion time in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. ```text DATABASE_URL="postgres://..." @@ -468,7 +468,7 @@ User should follow these steps (AI should provide these instructions): **Do NOT invent this URL. Use the one returned by `npx create-db`.** - If you ran `npx create-db` yourself, give the user the claim URL it printed. If the user ran it, remind them to open the claim URL in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. + If you ran `npx create-db` yourself, give the user the claim URL and deletion time it printed. If the user ran it, remind them to open the claim URL and check the deletion time in its output. The database is deleted after 24 hours unless they claim it with a free Prisma account. 5. **Update `prisma/schema.prisma`** — Add the User and Post models (generator and datasource are already configured): diff --git a/apps/docs/content/docs/postgres/npx-create-db.mdx b/apps/docs/content/docs/postgres/npx-create-db.mdx index 4caee480091..de2a682bd48 100644 --- a/apps/docs/content/docs/postgres/npx-create-db.mdx +++ b/apps/docs/content/docs/postgres/npx-create-db.mdx @@ -219,7 +219,7 @@ Here are the CLI flags for the `npx create-db` command: | `--region ` | `-r` | AWS region for the database.
**Available regions:** `ap-southeast-1`, `ap-northeast-1`, `eu-central-1`, `eu-west-3`, `us-east-1`, `us-west-1`. Without it, `create-db` picks the region closest to you (fallback `us-east-1`). | | `--interactive` | `-i` | Run in interactive mode to select a region. | | `--json` | `-j` | Output machine-readable JSON. | -| `--env ` | `-e` | Write `DATABASE_URL` and `CLAIM_URL` to the specified `.env` file and print the claim URL. If the file exists, the two lines are appended. | +| `--env ` | `-e` | Write `DATABASE_URL` and `CLAIM_URL` to the specified `.env` file and print the claim URL and deletion time. If the file exists, the two lines are appended. | | `--ttl ` | `-t` | Auto-delete after `30m`, or `1h` to `24h`. The default and maximum is `24h`. | | `--copy` | `-c` | Copy the connection string to your clipboard. | | `--quiet` | `-q` | Only output the connection string on stdout. The claim URL and deletion time go to stderr. | From f926608520d3be49c529a5cea27f746fb0d41793 Mon Sep 17 00:00:00 2001 From: Gregory Boch Date: Thu, 29 Oct 2026 16:13:11 +0100 Subject: [PATCH 4/5] docs(ai/prompts/astro): remind the user to claim when they ran create-db Co-Authored-By: Claude Opus 5.5 --- apps/docs/content/docs/ai/prompts/astro.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/docs/content/docs/ai/prompts/astro.mdx b/apps/docs/content/docs/ai/prompts/astro.mdx index e8026e007d7..8167d250a7e 100644 --- a/apps/docs/content/docs/ai/prompts/astro.mdx +++ b/apps/docs/content/docs/ai/prompts/astro.mdx @@ -82,7 +82,7 @@ export default prisma 5. You MUST wrap all database calls in try-catch blocks 6. You MUST import from `'../generated/prisma/client'` (not `'@prisma/client'`) 7. You MUST use `import.meta.env.DATABASE_URL` in Astro (not `process.env`) -8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db`, update `.env` with the returned `postgres://...` value, and give the user the claim URL and deletion time it prints (the database is deleted after 24 hours unless claimed) +8. You MUST use `npx prisma init --output ../src/generated/prisma` before editing the Prisma schema. If you need Prisma Postgres, run `npx create-db`, update `.env` with the returned `postgres://...` value, and give the user the claim URL and deletion time it prints (the database is deleted after 24 hours unless claimed). If the user runs `npx create-db` instead, remind them to open the claim URL and check the deletion time in its output ## CORRECT INSTALLATION From 6c03edd975bd2834415b1ef0f897315a39874b75 Mon Sep 17 00:00:00 2001 From: Gregory Boch Date: Thu, 29 Oct 2026 16:15:21 +0100 Subject: [PATCH 5/5] chore: retrigger the Vercel blog preview The blog deploy for f9266085 failed one second after it started; 697d18bd, with the same blog content, deployed fine. Co-Authored-By: Claude Opus 5.5