gammamatrix/playground-matrix-resource

Playground: Provides an API and a Blade UI for interacting with Playground Matrix, a Project Management System for Laravel applications.

Installs: 52

Dependents: 0

Suggesters: 1

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

pkg:composer/gammamatrix/playground-matrix-resource

dev-develop / 74.x-dev 2025-10-04 05:46 UTC

This package is auto-updated.

Last update: 2025-10-04 05:59:06 UTC


README

Playground CI Workflow Test Coverage PHPStan Level 10

Playground: Matrix Resource

This package provides an API and a Blade UI for interacting with the Playground: Matrix, a model package for Laravel.

If you need a JSON API without a UI, then have a look at Playground: Matrix API.

Documentation

Read more on using Playground: Matrix Resource at Read the Docs: Playground Documentation

Postman

A postman collection is provided in the repository: postman-playground-matrix-resource.json.

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 Resource 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-resource

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\Resource\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-resource.php

You can publish the routes file with:

php artisan vendor:publish --provider="Playground\Matrix\Resource\ServiceProvider" --tag="playground-routes"
  • The routes while be published in a folder at routes/playground-matrix-resource

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-resource git:(develop) ✗ composer cloc
    1276 text files.
    1254 unique files.
     256 files ignored.

github.com/AlDanial/cloc v 2.06  T=0.38 s (3318.2 files/s, 293934.6 lines/s)
-------------------------------------------------------------------------------
Language                     files          blank        comment           code
-------------------------------------------------------------------------------
YAML                           164              5              0          37783
JSON                           499              0              0          24987
PHP                            468           4988           5990          21999
Blade                          107            554              1          13594
XML                             12              0              7            965
Markdown                         3             58              1            137
INI                              1              3              0             12
-------------------------------------------------------------------------------
SUM:                          1254           5608           5999          99477
-------------------------------------------------------------------------------

PHPStan

Tests at level 10 on:

  • config/
  • resources/views/
  • routes/
  • src/
  • tests/Feature/
  • tests/Unit/
composer analyse

Coding Standards

Format source code:

composer format

Format blades in resources/views:

composer format-blade
  • NOTE: requires installing dev packages from package.json.
npm install

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.