prisma-platform-core-concepts

Explains Prisma Platform concepts for deploying, hosting, and operating Composer apps.

Updated Sep 16, 2026
One-click install
npx skills add https://github.com/roswell23/TodoFlow --skill prisma-platform-core-concepts-roswell23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prisma-platform-core-concepts
Source: https://github.com/roswell23/TodoFlow/tree/main/server/.cursor/skills/prisma-platform-core-concepts
Command: npx skills add https://github.com/roswell23/TodoFlow --skill prisma-platform-core-concepts-roswell23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants often carry outdated knowledge about the Prisma Platform, leading to wrong commands and broken deployments. This Skill ships inside the installed prisma package, so it describes the exact platform version your project uses and acts as the source of truth for hosting, deploying, and operating apps on Prisma Compute, Prisma Postgres, and Prisma Storage. ## Core Features & Use Cases - Resource model guidance: Explains workspaces, projects, branches as preview environments, services, versions, databases, and buckets, including lifecycle rules like idle reclamation and teardown. - Deployment workflows: Covers GitHub-integration deploys and CLI deploys with stages, plus promote, rollback, custom domains, and environment-variable classes and scopes. - Failure-mode reference: Documents ten common failure modes (lost secrets, rejected stage names, sleeping services killing background work, missing Temporal global) with their fixes. - Use Case: You push a feature branch and need a preview environment with its own database. The Skill explains that deploying with prisma deploy module.ts --stage pr-42 creates an isolated branch environment with a fresh database, and that deleting the git branch tears it down. ## Quick Start Ask the assistant 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?

Run prisma deploy module.ts --stage <name> to create a branch environment and deploy the identical app graph into it, or push a git branch with the GitHub integration connected. The stage name must be a valid git ref name, and the preview gets its own fresh database.

How do I roll back a production deployment on Prisma Compute?

Use the rollback operation in the service group to point production back at a previous version. A stopped target version is started and health-checked before traffic switches, so the rollback is zero-downtime.

Why did my Prisma preview environment disappear?

A preview environment is torn down when its upstream git branch is deleted, or reclaimed automatically when it sits idle and unpinned. Push or deploy the branch again to re-create it; the new database starts empty.

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

No. Environment variable values are write-only by design: listing shows names and scopes, never values, and no API returns them. To change a value you replace it, then re-deploy since variables resolve at deploy time.

Why does my deployed Prisma service fail on DateTime reads?

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

Does prisma dev work on Windows for local development?

No. The local Composer stack started by prisma dev module.ts is not supported on Windows yet. On supported platforms it provisions a local Prisma Postgres database, bucket stand-ins, and services with no cloud credentials required.