https://github.com/laravel-workflow/waterline

An elegant UI for monitoring Laravel Workflows.
https://github.com/laravel-workflow/waterline

background-jobs laravel php queues workflows

Last synced: 6 months ago
JSON representation

An elegant UI for monitoring Laravel Workflows.

• Host: GitHub
• URL: https://github.com/laravel-workflow/waterline
• Owner: laravel-workflow
• License: mit
• Created: 2022-10-31T03:35:59.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-09-08T00:25:57.000Z (10 months ago)
• Last Synced: 2025-10-19T06:03:57.559Z (8 months ago)
• Topics: background-jobs, laravel, php, queues, workflows
• Language: PHP
• Homepage:
• Size: 2.76 MB
• Stars: 186
• Watchers: 7
• Forks: 12
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Waterline

An elegant UI for monitoring [Laravel Workflows](https://github.com/laravel-workflow/laravel-workflow).

## Installation

This UI is installable via [Composer](https://getcomposer.org).

```bash

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.

```bash

composer require laravel-workflow/waterline

php artisan waterline:publish

```

## Dashboard View

![waterline_dashboard](https://user-images.githubusercontent.com/1130888/202864399-0bf0a3e7-4454-4a30-8fd2-e330b2460b76.png)

## Workflow View

![workflow](https://user-images.githubusercontent.com/1130888/202864523-edd88fce-0ce9-4e5a-a24c-38afeae4e057.png)

## Development

1. Install dependencies:

   ```bash

   composer install

   npm install

   ```

2. Build assets:

   ```bash

   npm run production

   ```

3. Publish assets to testbench:

   ```bash

   ./vendor/bin/testbench waterline:publish

   ```

4. Run migrations:

   ```bash

   ./vendor/bin/testbench workbench:create-sqlite-db

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

   ```

5. Start server:

   ```bash

   composer run serve

   ```

6. Access dashboard:

   - Local: http://localhost:8000/waterline

7. Create test workflow:

   ```bash

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

   ```

8. Run queue worker:

   ```bash

   ./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.