Prisma.Project reference

Branch

Source: src/Prisma/Branch.ts

A Prisma project branch for preview-class databases and compute resources.

Standalone Branch resources always have the preview role. Promotion changes only the default branch; Alchemy restores the previous default before deleting a promoted branch.

Branch: Creating a Branch

const branch = yield* Prisma.Branch("preview", {
  project: project.projectId,
  gitName: "feature/search", // optional — omitted, a stable name is generated
});

branch.role;      // "preview"
branch.isDefault; // false

Branch: Promoting a Branch

const release = yield* Prisma.Branch("release", {
  project,
  gitName: "release/next",
  isDefault: true,
});

release.role;      // still "preview"
release.isDefault; // true

Project

Source: src/Prisma/Project.ts

A Prisma project, optionally with a default Prisma Postgres database.

A Project is the ownership boundary for its databases, branches, apps, and repository link. Destroying this resource deletes the project and its contained data. Set createDatabase: false when you want standalone Prisma.Database resources with independent lifecycles.

Project: Creating a Project

Project with a default database

const project = yield* Prisma.Project("app", {
  name: "app",
  region: "us-east-1",
});

Project only

const project = yield* Prisma.Project("control-plane", {
  createDatabase: false,
});