Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
* text=auto

*.blade.php diff=html
*.css diff=css
*.html diff=html
*.md diff=markdown
*.php diff=php

/.github export-ignore
/docs export-ignore
/tests export-ignore
.editorconfig export-ignore
.gitattributes export-ignore
.gitignore export-ignore
CHANGELOG.md export-ignore
phpunit.xml.dist export-ignore
UPGRADE.md export-ignore
47 changes: 47 additions & 0 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
name: tests

on:
push:
branches:
- main
- "*.x"
pull_request:

jobs:
tests:
name: PHP ${{ matrix.php }} - Laravel ${{ matrix.laravel }}
runs-on: ubuntu-24.04

strategy:
fail-fast: true
matrix:
php: ["8.3", "8.4", "8.5"]
laravel: [12, 13]
include:
- laravel: 12
testbench: "^10.0"
- laravel: 13
testbench: "^11.0"
exclude:
- php: "8.5"
laravel: 12

steps:
- name: Checkout code
uses: actions/checkout@v5

- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: ${{ matrix.php }}
tools: composer:v2
coverage: none

- name: Install dependencies
run: |
composer update --prefer-dist --no-interaction --no-progress \
--with="illuminate/contracts=^${{ matrix.laravel }}.0" \
--with="orchestra/testbench=${{ matrix.testbench }}"

- name: Execute tests
run: vendor/bin/pest
46 changes: 46 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

### Changed

### Removed

## [0.2.1] - 2026-03-28

### Added

- This CHANGELOG file to hopefully serve as an evolving CHANGELOG.
- GitHub Actions workflow for automated testing.
- `.gitattributes` file to manage text file handling and export-ignore rules.

### Fixed

- README and documentation.

## [0.2.0] - 2026-03-27

### Added

- Support for Laravel 13. [#3](https://github.com/veeqtoh/prompt-deck/pull/3)
- Configuration option to toggle auto-scaffolding of prompts on agent creation
- This CHANGELOG file to hopefully serve as an evolving CHANGELOG.

### Fixed

- README and documentation.

## [0.1.0] - 2026-03-04

### Added

- First version. [#1](https://github.com/veeqtoh/prompt-deck/pull/1)
- README documenting the package.
- Link to package's full documentation: [full documentation](https://vu-ddaf4ff3.mintlify.app/).
7 changes: 5 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,9 @@
<a href="https://packagist.org/packages/veeqtoh/prompt-deck"><img src="https://img.shields.io/packagist/v/veeqtoh/prompt-deck?style=flat-square" alt="Latest Version on Packagist"></a>
<a href="https://packagist.org/packages/veeqtoh/prompt-deck"><img src="https://img.shields.io/packagist/php-v/veeqtoh/prompt-deck?style=flat-square" alt="PHP from Packagist"></a>
<a href="https://github.com/veeqtoh/prompt-deck/blob/master/LICENSE"><img src="https://img.shields.io/github/license/veeqtoh/prompt-deck?style=flat-square" alt="GitHub license"></a>
<a href="https://laravel-news.com/prompt-deck-manage-ai-prompts-as-versioned-files-in-laravel/">
<img src="https://img.shields.io/badge/Featured in Laravel News-%FF0000.svg?&style=flat-square&logo=laravel&logoColor=white" alt="https://laravel-news.com/prompt-deck-manage-ai-prompts-as-versioned-files-in-laravel"/>
</a>
</p>

## Introduction
Expand Down Expand Up @@ -102,7 +105,7 @@ class OrderAgent extends Agent
{
use HasPromptTemplate;

// instructions() and promptMessages() are provided automatically
// instructions() and promptMessages() are provided automatically.
}
```

Expand Down Expand Up @@ -134,4 +137,4 @@ Prompt Deck is open-sourced software licensed under the [MIT license](LICENSE).

## Support

This library is created by [Victor Ukam](https://victorukam.com) with contributions from the [Open Source Community](https://github.com/veeqtoh/prompt-deck/graphs/contributors). If you've found this package useful, please consider [sponsoring this project](https://github.com/sponsors/veeqtoh). It will go along way to help with maintenance.
This library is created by [Victor Ukam](https://victorukam.com) with contributions from the [Open Source Community](https://github.com/veeqtoh/prompt-deck/graphs/contributors). If you've found this package useful, please consider [sponsoring this project](https://github.com/sponsors/veeqtoh). It will go a long way to help with maintenance.
28 changes: 19 additions & 9 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,35 +4,43 @@
"type": "library",
"homepage": "https://github.com/veeqtoh/prompt-deck",
"license": "MIT",
"support": {
"issues": "https://github.com/veeqtoh/prompt-deck/issues",
"source": "https://github.com/veeqtoh/prompt-deck"
},
"authors": [
{
"name": "Victor Ukam",
"email": "victorjohnukam@gmail.com"
}
],
"keywords": [
"veeqtoh",
"victor-ukam",
"ai",
"laravel",
"laravel-package",
"laravel-ai",
"laravel-ai-sdk",
"agentic-prompting",
"agentic-ai",
"prompt-management",
"versioned-prompts",
"file-based-prompts",
"variable-interpolation",
"performance-tracking",
"ab-testing",
"laravel",
"laravel-package"
"victor-ukam"
],
"require": {
"php": "^8.2",
"sebastian/diff": "^7.0.0",
"nesbot/carbon": "^3.0",
"illuminate/container": "^11.0|^12.0",
"illuminate/database": "^11.0|^12.0",
"illuminate/support": "^11.0|^12.0"
"illuminate/container": "^11.0|^12.0|^13.0",
"illuminate/database": "^11.0|^12.0|^13.0",
"illuminate/support": "^11.0|^12.0|^13.0"
},
"require-dev": {
"mockery/mockery": "^1.0",
"orchestra/testbench": "^10.0",
"orchestra/testbench": "^10.0|^11.0",
"pestphp/pest": "^4.3",
"pestphp/pest-plugin-laravel": "^4.0",
"laravel/pint": "^1.27"
Expand All @@ -42,7 +50,9 @@
},
"autoload": {
"psr-4": {
"Veeqtoh\\PromptDeck\\": "src/"
"Veeqtoh\\PromptDeck\\": "src/",
"Veeqtoh\\PromptDeck\\Database\\Factories\\": "src/database/factories/",
"Veeqtoh\\PromptDeck\\Database\\Seeders\\": "src/database/seeders/"
}
},
"autoload-dev": {
Expand Down
Loading