ristekusdi/adminkit-laravel

Starter kit to accelerate develop internal web app in Universitas Udayana

v1.0.0-beta 2023-01-10 05:25 UTC

Requires

• php: ^8.0.2
• guzzlehttp/guzzle: ^7.2
• laravel/framework: ^9.19
• laravel/sanctum: ^3.0
• laravel/tinker: ^2.7
• livewire/livewire: ^2.10
• ristekusdi/rbac-connector: ^2.0
• ristekusdi/sso-laravel: ^1.1

Requires (Dev)

• fakerphp/faker: ^1.9.1
• laravel/pint: ^1.0
• laravel/sail: ^1.0.1
• mockery/mockery: ^1.4.4
• nunomaduro/collision: ^6.1
• phpunit/phpunit: ^9.5.10
• spatie/laravel-ignition: ^1.0

MIT

• Riset dan Teknologi USDI

• laravel
• starter kit

README

Starter kit to accelerate develop internal web app in Universitas Udayana. Build with AdminKit in Laravel + integrate with Single Sign On Universitas Udayana.

Frameworks + Tools

• PHP version >= 8.0.2
• Laravel 9.x + ViteJS
• Livewire 2.x
• AlpineJS
• Boostrap 5 [without jQuery])(https://blog.getbootstrap.com/2021/05/05/bootstrap-5/#javascript)
• RistekUSDI SSO Laravel
• RistekUSDI RBAC Connector

Installation

Run command below.

For non-production ready please add flag --stability=dev as below.

composer create-project --stability=dev ristekusdi/adminkit-laravel example-app

Note: if you install with the command above, you don't need to run php artisan key:generate because it already take care by the composer scripts. :)

1. Create database with the name of your application then update your database configuration in .env file.

2. Copy KEYCLOAK_* environment value for SSO and RBAC_CONNECTOR_HOST_URL for get list of users and client roles from your client in IMISSU2 and copy it to .env file.

Note: imissu2-dev for development and imissu2 for production.

1. Run php artisan migrate.

2. Run php artisan db:seed to run seeder for menus, permissions, and roles.

3. Run npm install to install JavaScript dependencies that need for this starter kit.

4. Run php artisan serve in currrent command tab and npm run dev in another command tab.

Notes

1. Command php artisan serve is for running application on PHP development server.
2. Command npm run dev is for generate CSS and JavaScript assets for application.
3. If you use another port except default port (8000) from Laravel, you may run php artisan serve --port=<port-number> command.
4. if you use custom domain .test with Laravel Valet or Traefik, you need to change the value of APP_URL because its related with generate CSS and JavaScript assets in your development server.