gammamatrix / playground-matrix-api
Playground: Provides an API, without a UI for interacting with Playground Matrix, a Project Management System for Laravel applications.
Installs: 19
Dependents: 0
Suggesters: 1
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
pkg:composer/gammamatrix/playground-matrix-api
Requires
Requires (Dev)
- gammamatrix/playground-test: *
- illuminate/testing: ^12.0
- laravel/sanctum: ^4.0
This package is auto-updated.
Last update: 2025-10-04 17:43:04 UTC
README
Playground: Matrix API
This package provides an API without UI for interacting with the Playground: Matrix, a model package for Laravel.
If you need a JSON API with a UI, then have a look at Playground: Matrix Resource.
Documentation
Read more on using Playground: Matrix API at Read the Docs: Playground Documentation
Postman
A postman collection is provided in the repository: postman-playground-matrix-api.json.
- This same collection is viewable on the Postman: GammaMatrix Playground Workspace.
OpenAPI
This application provides OpenAPI documentation: openapi.yaml.
- The endpoint models support locks, trash with force delete, restoring, revisions and more.
- Index endpoints support advanced query filtering.
OpenAPI API Documentation is built with npm using Redocly.
- npm is only needed to generate documentation and is not needed to operate the Playground: Matrix API API.
See package.json requirements.
Install npm.
npm install
Build the documentation to generate the openapi.yaml configuration.
npm run docs
Documentation
Installation
You can install the package via composer:
composer require gammamatrix/playground-matrix-api
artisan about
Playground provides information in the artisan about
command.
Configuration
You can publish the config file with:
php artisan vendor:publish --provider="Playground\Matrix\Api\ServiceProvider" --tag="playground-config"
All routes are enabled by default. They may be disabled via environment variable or the configuration.
See the contents of the published config file: config/playground-matrix-api.php
You can publish the routes file with:
php artisan vendor:publish --provider="Playground\Matrix\Api\ServiceProvider" --tag="playground-routes"
- The routes while be published in a folder at
routes/playground-matrix-api
Environment Variables
If you are unable or do not want to publish configuration files for this package, you may override the options via system environment variables.
Information on environment variables is available on the wiki for this package
Migrations
This package requires the migrations in playground-matrix a Laravel package.
Cloc
composer cloc
➜ playground-matrix-api git:(develop) ✗ composer cloc
1141 text files.
1120 unique files.
249 files ignored.
github.com/AlDanial/cloc v 2.06 T=0.33 s (3396.8 files/s, 335144.1 lines/s)
-------------------------------------------------------------------------------
Language files blank comment code
-------------------------------------------------------------------------------
JSON 481 0 0 42797
YAML 164 5 0 37527
PHP 461 4303 5637 19462
XML 10 0 7 568
Markdown 3 55 1 126
INI 1 3 0 12
-------------------------------------------------------------------------------
SUM: 1120 4366 5645 100492
-------------------------------------------------------------------------------
PHPStan
Tests at level 10 on:
config/
routes/
src/
tests/Feature/
tests/Unit/
composer analyse
Coding Standards
composer format
Testing
Run unit tests:
composer test
Run unit and feature tests:
composer test-dev
Run unit and feature tests in parallel:
composer test-parallel
Changelog
Please see CHANGELOG for more information on what has changed recently.
License
The MIT License (MIT). Please see License File for more information.