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.
npx create-prisma-php-app@latest my-projectOne-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.
npx create-prisma-php-app@latest my-app --starter-kit=basic
Full-Stack Kit
Complete web app with TailwindCSS v4, PostCSS, and Prisma ORM integration.
npx create-prisma-php-app@latest my-web-app --starter-kit=fullstack
REST API Kit
Containerized headless API. Includes Docker Compose and Swagger documentation.
npx create-prisma-php-app@latest my-api --starter-kit=api
Real-Time Kit
Event-driven stack with Ratchet WebSockets and Model Context Protocol (MCP).
npx create-prisma-php-app@latest 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.
npx create-prisma-php-app@latest 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. |