README

An elegant UI for monitoring Laravel Workflows.

Installation

This UI is installable via Composer.

composer require laravel-workflow/waterline

php artisan waterline:install

Authorization

Waterline exposes a dashboard at the /waterline URL. By default, you will only be able to access this dashboard in the local environment. However, within your app/Providers/WaterlineServiceProvider.php file, there is an authorization gate definition. This authorization gate controls access to Waterline in non-local environments.

Gate::define('viewWaterline', function ($user) {
    return in_array($user->email, [
        'admin@example.com',
    ]);
});

This will allow only the single admin user to access the Waterline UI.

Upgrading Waterline

After upgrading Waterline you must publish the latest assets.

composer require laravel-workflow/waterline

php artisan waterline:publish

Dashboard View

Workflow View

Development

Install dependencies:
```
composer install
npm install
```
Build assets:
```
npm run production
```

Publish assets to testbench:

./vendor/bin/testbench waterline:publish

Run migrations:

./vendor/bin/testbench workbench:create-sqlite-db
./vendor/bin/testbench migrate:fresh --database=sqlite

Start server:
```
composer run serve
```
Access dashboard:
- Local: http://localhost:8000/waterline

Create test workflow:

./vendor/bin/testbench workflow:create-test

Run queue worker:
```
./vendor/bin/testbench queue:work
```

_{^{"Laravel" is a registered trademark of Taylor Otwell. This project is not affiliated, associated, endorsed, or sponsored by Taylor Otwell, nor has it been reviewed, tested, or certified by Taylor Otwell. The use of the trademark "Laravel" is for informational and descriptive purposes only. Laravel Workflow is not officially related to the Laravel trademark or Taylor Otwell.}}

laravel-workflow / waterline

Maintainers

Details