prisma-platform-core-concepts

Explains Prisma Platform concepts for deploying services, databases, and preview environments.

Updated Sep 12, 2026
One-click install
npx skills add https://github.com/praveens649/project-management-system --skill prisma-platform-core-concepts-praveens649
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prisma-platform-core-concepts
Source: https://github.com/praveens649/project-management-system/tree/main/server/.agents/skills/prisma-platform-core-concepts
Command: npx skills add https://github.com/praveens649/project-management-system --skill prisma-platform-core-concepts-praveens649

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying and operating apps on the Prisma Platform involves unfamiliar concepts like branches-as-environments, service versions, and write-only environment variables, and outdated knowledge leads to broken deploys and lost secrets. ## Core Features & Use Cases - Resource Model Guidance: Explains workspaces, projects, branches, services, versions, databases, and buckets, and how they relate. - Deployment Workflows: Covers GitHub-connected deploys, CLI deploys with stages, promotion, rollback, and custom domains. - Failure Mode Reference: Documents ten common failure modes such as one-time secrets, reclaimed previews, and missing Temporal support, with fixes. - Use Case: You push a feature branch and need a preview environment with its own database; this Skill explains that the branch itself is the environment and how prisma deploy --stage creates it. ## Quick Start Ask the AI to explain how to deploy a preview environment with its own database on the Prisma Platform using the prisma CLI.

Frequently Asked Questions about prisma-platform-core-concepts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a preview environment on the Prisma Platform?

Push a git branch with the GitHub integration connected, or run prisma deploy module.ts --stage <name> from the CLI. The branch itself is the environment and gets its own services, databases, and buckets automatically.

How do Prisma Platform preview branches get databases?

A preview branch that declares a database in the module gets a fresh, empty Prisma Postgres database wired in as a branch-scoped DATABASE_URL. Schema comes from committed migrations; production data never carries over.

Can I read environment variable values back from the Prisma Platform?

No, environment variable values are write-only by design. Listing shows names and scopes only, and no API returns values; to change a value you replace it and re-deploy since variables resolve at deploy time.

Why did my Prisma Platform preview environment disappear?

Preview environments are torn down when their upstream git branch is deleted, or reclaimed automatically when idle and unpinned. Push or deploy the branch again to re-create it, but the database starts empty.

Why does my deployed service fail on timestamp reads?

The Compute runtime has no global Temporal, so reading ORM DateTime columns throws RUNTIME.TEMPORAL_UNAVAILABLE. Add the temporal-polyfill dependency and import it at the service entry, or use the *String column types.

What are the limitations of the Prisma Platform CLI?

The CLI cannot create or delete branches directly, retry failed builds, read environment variable values, or rename buckets. Branches are created by pushing or deploying a stage and removed by deleting the git branch.