prisma-platform-core-concepts

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

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/Sonal-Github1/CeylonWise --skill prisma-platform-core-concepts-sonal-github1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prisma-platform-core-concepts
Source: https://github.com/Sonal-Github1/CeylonWise/tree/main/frontend/.cursor/skills/prisma-platform-core-concepts
Command: npx skills add https://github.com/Sonal-Github1/CeylonWise --skill prisma-platform-core-concepts-sonal-github1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with the Prisma Platform requires understanding its resource model of workspaces, projects, branches, services, databases, and buckets, and outdated knowledge about Prisma hosting leads to deployment errors and misconfigured environments. ## Core Features & Use Cases - Deployment Workflows: Deploy via the GitHub integration or the prisma deploy CLI command, with automatic preview environments created per git branch. - Resource Model Guidance: Understand workspaces, projects, branches as isolated environments, services with immutable versions, Prisma Postgres databases, and S3-compatible buckets. - Operations Reference: Handle promotions, rollbacks, custom domains, environment variables, secrets rotation, and common failure modes like sleeping services and missing Temporal support. - Use Case: You push a feature branch and need a preview environment with its own database. This Skill explains that the platform creates the branch environment automatically on push, provisions a fresh database, and tears everything down when the git branch is deleted. ## Quick Start Ask the AI to explain how to deploy your Composer app to a preview environment using the Prisma Platform and what happens to its database when the branch is deleted.

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, and the platform creates the branch environment, builds, and deploys automatically. From the CLI, run prisma deploy module.ts --stage pr-42 to deploy the same app graph into a named preview branch.

How do Prisma Platform branches and preview environments work?

A branch is the environment itself; there is no separate preview object to create. The first branch is production, every later branch is a preview with its own services, databases, buckets, and environment-variable overrides, and previews get fresh empty databases.

Can I read back environment variable values on 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 variables resolve at deploy time so a re-deploy is needed to pick up changes.

Why does my deployed Prisma service fail on timestamp 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 like TimestamptzString.

Why did my Prisma preview environment disappear?

A preview is torn down when its upstream git branch is deleted, and idle unpinned previews can be reclaimed automatically. Push or deploy the branch again to re-create it, but the database starts empty since data does not persist.

What are the limitations of the Prisma Platform CLI?

The branch group only lists branches; there is no CLI create or teardown verb, no build retry, no reading of environment-variable values, and no bucket rename or re-association. Check the nearest command group with --help before concluding a feature is missing.