GitHub Project PHP is a Laravel package that helps you manage your GitHub Projects (V2) in PHP.
It provides a simple webhook system to receive GitHub project events and automatically generate activity comments on issues and pull requests.
- Webhook Integration: Receive and process GitHub Projects V2 webhook events
- Queue Support: Process webhook events asynchronously for better performance
- API Endpoint: Generate comment messages via REST API
- 12+ Field Type Templates: Built-in templates for all GitHub Project field types
- Customizable Templates: Publish and customize Blade templates
- GitHub GraphQL API: Direct integration with GitHub's GraphQL API
- PHP ^8.4
- Laravel ^11.0|^12.0
- Composer
composer require cslant/github-project-php
| Field Type | Description |
|---|---|
text |
Simple text fields |
number |
Numeric fields |
date |
Date fields (Y-m-d format) |
single_select |
Single-select dropdowns with color support |
multi_select |
Multi-select fields |
checkbox |
Boolean/toggle fields |
textarea |
Long text content with diff view |
iteration |
Iteration/sprint fields |
labels |
Label/tag fields |
assignees |
User assignment fields |
milestone |
Milestone tracking |
unsupported |
Fallback for unknown field types |
See the GitHub Project PHP Documentation for detailed usage instructions.
php artisan vendor:publish --provider="CSlant\GitHubProject\GithubProjectServiceProvider" --tag="views"
This copies templates to resources/views/vendor/github-project/md/field_types/.
All field type templates receive:
$fieldName- Display name of the field$fieldType- Type of the field$fromValue- Previous value$toValue- New value$fieldData- Raw webhook data
Generate comment messages via API:
POST /github-project/generate-comment
Content-Type: application/json
{
"payload": { ... }
}
Enable queue processing in your config:
// config/github-project.php 'is_queue_enabled' => true,
Full documentation available at docs.cslant.com/github-project-php
Please see CHANGELOG for more information on what has changed recently.
The MIT License (MIT). Please see License File for more information.