prisma-platform-core-concepts

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

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/hafisalrizal/aymartech-technical-test-solution --skill prisma-platform-core-concepts-hafisalrizal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prisma-platform-core-concepts
Source: https://github.com/hafisalrizal/aymartech-technical-test-solution/tree/main/packages/backend/.cursor/skills/prisma-platform-core-concepts
Command: npx skills add https://github.com/hafisalrizal/aymartech-technical-test-solution --skill prisma-platform-core-concepts-hafisalrizal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers hosting apps on the Prisma Platform often rely on outdated training data about its resource model, deployment workflows, and CLI behavior. This Skill provides version-accurate guidance on projects, branches, preview environments, services, Prisma Postgres, object storage, and environment variables so deployments and operations follow the actual platform semantics. ## Core Features & Use Cases - Resource Model Guidance: Explains the workspace-project-branch hierarchy, where each branch is an isolated environment with its own services, databases, and buckets. - Deployment Workflows: Covers GitHub-integration deploys and CLI deploys with prisma deploy, including stage-based preview environments, promotion, and zero-downtime rollback. - Operational Troubleshooting: Documents ten common failure modes such as one-time secrets, reclaimed previews, sleeping services, and missing Temporal support in the Compute runtime. - Use Case: You push a feature branch and need a preview environment with its own database. The Skill explains that pushing the branch automatically creates the environment with a fresh Prisma Postgres database wired as a branch-scoped DATABASE_URL. ## Quick Start Ask the assistant to explain how to deploy a preview environment for a pull request using the Prisma Platform 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 with the Prisma CLI?

Run prisma deploy module.ts --stage <name> to create a branch named after the stage and deploy the identical app graph into it. The stage name must be a valid git ref name, and the preview gets its own fresh database wired as a branch-scoped DATABASE_URL.

How does the Prisma GitHub integration deploy branches?

Connect the repository with prisma git connect or via the Console, then every push builds and deploys automatically. Pushes to the default branch deploy production, while pushes to other branches create or update preview environments without any workflow file.

Why did my Prisma preview environment disappear?

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

Can I read back environment variable values on Prisma Platform?

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

Why does my deployed Prisma service fail on timestamp reads?

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

What are the limitations of Prisma Platform branch management?

The CLI branch group only lists branches; there is no create or delete verb. Branches are created by pushing or deploying a stage and removed by deleting the upstream git branch, and failed builds cannot be retried except by the next push or deploy.