Laravel Feedback — Floating widget + Filament triage + notification drivers

A drop-in floating feedback widget for Laravel apps — sentiment + free-text + optional email, with a per-page mode switch (feedback / bug / notify), a Filament admin resource for triage, and pluggable notification drivers (mail / Slack / Telegram / webhook). Designed for solo founders and product teams that want voice-of-customer in every property without paying for Userback / Canny / Marker.

Why this exists. "Add a feedback button" is one of those tiny tasks that turns into a week — a widget, an endpoint, rate-limiting, storage, an admin view, notifications, i18n, RTL. This package gives you all of it in one composer require. It's already running in production in Toolenza — this package extracts it so every Laravel app can use the same surface.

Try it live: Working integrations across plugins-demo.codenzia.com, aqarkom.com, and Toolenza show the three modes side-by-side.

Features

• Floating Alpine.js widget — bottom-right pill, animated panel, dark-mode aware, RTL-aware (dir="auto").
• Three built-in modes per page:
  • feedback — sentiment + message + optional email
  • bug — same shape, tagged for the bug triage filter
  • notify — email required, message optional, no sentiment — perfect for "Notify me when this ships" lead capture
• Per-page context tagging — pass ['plugin' => 'filament-comments', 'tenant' => 42] and it's captured in the context JSON column for downstream triage.
• Filament v4/v5 admin resource — list, sentiment column, mode badge, mailto reply action, one-click triage, navigation badge for untriaged count.
• Rate-limited — per-IP, 10/hour by default (configurable). IP is hashed, never stored raw.
• Auto-fills email for signed-in users in non-notify modes.
• Pluggable notification drivers — mail, slack, telegram, webhook. Drivers run sequentially on every submission via the FeedbackReceived event. Extend with your own.
• i18n — ships with English + Arabic; publishable for any locale.
• Anonymous-friendly — user_id is nullable; works for logged-out marketing pages.
• Suppressible in embeds — set View::share('feedbackSuppressed', true) inside iframe routes so embeds don't pollute the host page.

Requirements

Installation

Publish the config, migration, lang, and (optionally) views:

Quick Start

1. Drop the widget into your layout

That's it — a "Feedback" pill renders bottom-right and POSTs to /api/feedback.

2. Use the modes per page

3. Register the Filament admin resource

In your panel provider:

Or set feedback.filament.auto_register => true in config to register it on every panel automatically.

Notification drivers

Configure which drivers run on each submission via the FEEDBACK_DRIVERS env var (comma-separated):

Drivers run sequentially and swallow their own exceptions — a misconfigured Slack webhook won't block the mail behind it.

Custom drivers

Add it to FEEDBACK_DRIVERS=mail,intercom and you're done.

Custom event listeners

Hook the FeedbackReceived event for app-specific side-effects:

Database schema

The package's migration creates a feedback_messages table:

Configuration

After publishing, edit config/feedback.php. Key sections:

Full options in config/feedback.php.

Migrating Toolenza to this package

If you're migrating from a pre-existing in-app implementation (Toolenza's, or anything modelled on it):

1. Install the package: composer require codenzia/laravel-feedback.
2. Publish only config for now: php artisan vendor:publish --tag=feedback-config.
3. Update your existing feedback_messages migration to add the two new columns (or roll a new migration):

   Schema::table('feedback_messages', function (Blueprint $table): void {
       $table->string('mode', 16)->default('feedback')->after('source_url');
       $table->json('context')->nullable()->after('message');
       $table->index('mode');
   });
   

4. Delete your in-app App\Models\FeedbackMessage, App\Http\Controllers\FeedbackController, App\Filament\...\FeedbackMessageResource, and the feedback-widget.blade.php component.
5. Remove the POST /api/feedback route from routes/web.php (the package registers it).
6. Replace every <x-feedback-widget /> (or whatever your in-app name was) with @include('laravel-feedback::widget').
7. Register the Filament plugin in your panel provider (see Quick Start above).
8. Move any in-app references to App\Models\FeedbackMessage to Codenzia\LaravelFeedback\Models\FeedbackMessage.
9. Run tests. Your existing rows continue to work — mode defaults to feedback for legacy rows.

Testing

License

The MIT License (MIT). Please see License File for more information.