Requirements
Deck by PromptPHP has the following requirements:Deck requires the
sebastian/diff package for the prompt:diff command.
It may conflict with your PHPUnit/Pest PHP installation. If it does,
upgrade these dependencies to the latest version.Optional dependencies
Installing Deck by PromptPHP
Install the package via Composer:If you have disabled auto-discovery, you will need to manually register the
service provider and facade. See the Manual discovery
section for details.
Publishing the configuration
Publish the configuration file to customise Deck’s behaviour:config/deck.php in your application. See the Configuration documentation for a full reference of all available options.
Publishing migrations
If you plan to use database tracking for prompt versions and execution logging, publish and run the migrations:Database tracking is optional. Deck works fully without it. Version
activation falls back to
metadata.json files, and execution tracking is
disabled.Environment variables
Add the following to your.env file to configure Deck’s runtime behaviour:
Verifying the installation
After installation, verify everything is working:resources/prompts/hello-world/.
Manual discovery
The package uses Laravel’s auto-discovery, so Laravel registers the service provider and facade automatically. You don’t need to register them manually. If you have disabled auto-discovery, add the provider and facade to yourbootstrap/providers.php (Laravel 11+) or config/app.php:
config/app.php:
What’s next?
Configuration
Customise Deck’s behaviour.
Creating prompts
Learn the full
make:prompt command.Working with prompts
Load, render, and manage prompts in your code.
Laravel AI SDK
Use prompts with AI agents.