dejwcake/admin-ui

Administration user interface template

1.0.0 2025-02-24 17:41 UTC

Requires

• php: ^8.2
• arondeparon/laravel-request-sanitizer: ^6.0
• illuminate/support: ^12.0
• intervention/image-laravel: ^1.5.2
• spatie/image-optimizer: ^1.8

Requires (Dev)

• larastan/larastan: ^3.1
• mockery/mockery: ^1.6
• orchestra/testbench-browser-kit: ^10.0
• phpunit/phpunit: ^11.5.9

MIT

• David Běhal
• Pavol Perdík
• Matej Minár
• Dušan Subally

• admin
• template
• cms
• laravel
• administration
• admin-ui

README

Admin UI is an administration template for Laravel 11. It provides admin layout and basic UI elements to build up an administration area (CMS, e-shop, back-office, ...).

Example of an administration interface built with this package:

This packages is part of Craftable (brackets/craftable) - an administration starter kit for Laravel 11. You should definitely have a look :)

You can find full documentation at https://docs.getcraftable.com/#/admin-ui

Composer

To develop this package, you need to have composer installed. To run composer command use:

  docker compose run -it --rm test composer update

For composer normalization:

  docker compose run -it --rm php-qa composer normalize

Run tests

To run tests use this docker environment.

  docker compose run -it --rm test vendor/bin/phpunit  -d pcov.enabled=1

To switch between postgresql and mariadb change in docker-compose.yml DB_CONNECTION environmental variable:

- DB_CONNECTION: pgsql
+ DB_CONNECTION: mysql

Run code analysis tools

To be sure, that your code is clean, you can run code analysis tools. To do this, run:

For php compatibility:

  docker compose run -it --rm php-qa phpcs --standard=.phpcs.compatibility.xml --cache=.phpcs.cache

For code style:

  docker compose run -it --rm php-qa phpcs -s --colors --extensions=php

or to fix issues:

  docker compose run -it --rm php-qa phpcbf -s --colors --extensions=php

For static analysis:

  docker compose run -it --rm php-qa phpstan analyse --configuration=phpstan.neon

For mess detector:

  docker compose run -it --rm php-qa phpmd ./src,./install-stubs,./lang,./resources,./routes,./tests ansi phpmd.xml --suffixes php --baseline-file phpmd.baseline.xml

Issues

Where do I report issues? If something is not working as expected, please open an issue in the main repository https://github.com/BRACKETS-by-TRIAD/craftable.