Prisma PHP Logo

Installation via Starter Kits

The Prisma PHP CLI allows you to bootstrap projects using specific "Starter Kits". These kits pre-configure dependencies, flags, and directory structures so you don't have to manually set up Docker, WebSockets, or Swagger.

Interactive Mode

If you run the command without arguments, the CLI will guide you through an interactive wizard to select your kit.

terminal 
npx create-prisma-php-app my-project

One-Command Installation

You can skip the wizard by specifying a --starter-kit. This automatically applies the correct flags (like Docker or Tailwind) associated with that kit.

Basic Kit

Minimal setup. No frontend assets, no Docker. Just a raw PHP backend environment.

backend-only 
npx create-prisma-php-app my-app --starter-kit=basic

Full-Stack Kit

Complete web app with TailwindCSS v4, PostCSS, and Prisma ORM integration.

tailwindcss prisma swagger-docs 
npx create-prisma-php-app my-web-app --starter-kit=fullstack

REST API Kit

Containerized headless API. Includes Docker Compose and Swagger documentation.

docker backend-only swagger-docs 
npx create-prisma-php-app my-api --starter-kit=api

Real-Time Kit

Event-driven stack with Ratchet WebSockets and Model Context Protocol (MCP).

websocket mcp tailwindcss 
npx create-prisma-php-app my-chat --starter-kit=realtime

Installing Custom Kits

Git Repository as a Source

You can install any Prisma PHP project directly from a Git repository. The CLI will clone the repo, remove the .git history, and update the configuration with your new project name.

Custom Source Example 
npx create-prisma-php-app internal-tool \
  --starter-kit=custom \
  --starter-kit-source=https://github.com/my-org/admin-template.git
  • Auto-installs Composer dependencies
  • Renames project in prisma-php.json

Post-Installation Checklist

Action Description
.env setup Verify DATABASE_URL and APP_KEY in the generated .env file.
npm run dev Starts the Vite development server (for Fullstack/Realtime kits).
docker-compose up Required if you selected the API or Ecommerce kits.