docker-prisma-setup

Bootstrap Docker Postgres and Redis containers and prepare a Prisma-enabled TypeScript service.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill docker-prisma-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-prisma-setup
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/docker-prisma-setup
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill docker-prisma-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides an end-to-end setup for a TypeScript backend that uses Docker Compose (Postgres + Redis) and Prisma, removing friction when onboarding, recovering a broken local database, or initializing a fresh development environment. It addresses common failures such as Docker daemon hangs, workspace protocol dependency issues, missing environment files, migration troubles, and seed script failures.

Core Features & Use Cases

  • Docker orchestration & recovery: Detects Docker health, restarts Docker Desktop if hung, and brings up required containers.
  • Environment wiring: Reads prisma schema and docker-compose to create a .env with DATABASE_URL and REDIS_URL and checks gitignore hygiene.
  • Dependency & Prisma workflow: Chooses the correct package manager (bun/pnpm/npm) for workspace protocols, installs deps from the monorepo root, generates the Prisma client, runs migrations, and executes seed scripts.
  • Use Case: Onboard a new developer to a backend service with docker-compose + Prisma or recover a developer's local DB after corruption.

Quick Start

Point this skill at the service root containing docker-compose.yml and prisma to start containers, generate the Prisma client, run migrations, and seed the database.

Frequently Asked Questions about docker-prisma-setup

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

FAQPage Schema
How do I set up a local Docker Postgres and Redis environment for a Prisma TypeScript service?

To set up a local Docker Postgres and Redis environment for Prisma, the skill orchestrates Docker containers, generates the Prisma client, runs migrations, and executes the seed script automatically. It targets monorepo services containing a docker-compose.yml and prisma/schema.prisma.

Why does my Prisma migration fail when onboarding with Docker Compose in a monorepo?

Prisma migration failures during Docker Compose onboarding often stem from Docker daemon hangs or missing environment files. The skill resolves this by checking Docker health, restarting Docker Desktop if hung, and creating a .env with the correct DATABASE_URL and REDIS_URL.

How do I install monorepo dependencies with workspace protocols before running Prisma generate?

Installing monorepo dependencies with workspace protocols before running Prisma generate requires choosing the correct package manager. The skill detects and uses bun, pnpm, or npm to install dependencies from the monorepo root, handling workspace:* gotchas automatically.

Can I use this to recover a corrupted local Postgres database for a TypeScript backend?

Yes, you can use this to recover a corrupted local Postgres database for a TypeScript backend. The skill performs Docker health checks, restarts containers, applies Prisma migrations, and runs the seed script to restore the local development environment.

Does this Docker Prisma setup work with both bun and pnpm package managers?

Yes, the Docker Prisma setup works with both bun and pnpm package managers. It automatically chooses the correct package manager to install dependencies from the monorepo root, specifically handling workspace protocol issues before running prisma generate and migrate dev.

What do I need to bootstrap a fresh development environment with Docker and Prisma?

To bootstrap a fresh development environment with Docker and Prisma, you need a service root containing docker-compose.yml and a prisma directory. The skill then brings up the required Postgres and Redis containers, wires the .env file, and executes the full database migration workflow.