# Deploy to Prisma — instructions for coding agents

You fetched https://prisma.build, the root domain of Prisma app hosting.
Prisma is one platform for TypeScript apps: a type-safe ORM, managed
Postgres, and app hosting (Prisma Compute, Public Beta) driven by one CLI.
Model your data, store it, deploy with one command.

## Commands

Run every command as `npx @prisma/cli@latest <command>`. Add --json for
machine-readable output and --no-interactive for scripts.

1. Check auth state:
   npx @prisma/cli@latest auth whoami --json
   Signing in (auth login) opens a browser and needs a human. In CI or
   headless environments, set a service token in the PRISMA_SERVICE_TOKEN
   environment variable instead. Never print the token.
2. Deploy from the app directory:
   npx @prisma/cli@latest app deploy --db
   - The CLI detects Next.js, Nuxt, Astro, Hono, NestJS, TanStack Start, or
     a plain Bun server. For Elysia and custom servers, pass
     --framework bun --entry <path>.
   - --db provisions a Prisma Postgres database and wires its connection
     string into this deploy target. It does not run migrations.
   - The first deploy creates the project and prints a live URL; it is
     promoted to production automatically. Later deploys to the production
     branch require an explicit --prod flag.
3. Starting from nothing?
   npx create-prisma@latest
   scaffolds an app (Hono, Elysia, Next.js, Nuxt, Astro, NestJS, SvelteKit,
   TanStack Start, or Turborepo) and can deploy it in the same run.
4. Verify the deploy: `app open` opens the live URL, `app logs` streams
   runtime logs.

## Runtime requirements

- The deployed server must bind all interfaces (0.0.0.0, not localhost) and
  listen on the deployed HTTP port: read process.env.PORT, or pass a
  matching --http-port.
- Next.js apps must set output: "standalone" in their config. The
  create-prisma template already does.

## Branching

A project groups one codebase. Each branch — production or preview — owns an
isolated app, database, environment variables, and URL, so preview work never
touches production. Pass --branch <name> to target a preview branch. Connect
GitHub with `git connect` and every push deploys its branch automatically.

## Docs

- https://www.prisma.io/docs/compute — Prisma Compute
- https://www.prisma.io/docs/prisma-compute/deploy — deploy your first app
- https://www.prisma.io/docs/compute/cli-reference — CLI reference
- https://www.prisma.io/docs/llms.txt — docs index for agents
- Append .md to any docs page URL for a markdown version.