pharaonic / laravel-reacts

13.0.0 2026-11-14 09:02 UTC

Requires

• php: >=8.3 <8.6
• ext-mbstring: *
• illuminate/contracts: ^13.0
• illuminate/database: ^13.0
• illuminate/support: ^13.0

Requires (Dev)

• laravel/pint: ^1.20
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• phpstan/phpstan: ^2.1.33
• phpunit/phpunit: ^12.5.8

MIT

• Moamen Eltouny (Raggi)

• emoji
• laravel
• eloquent
• polymorphic
• reactions
• pharaonic
• reacts

Published on Packagist.org on 2026-11-14 09:02 UTC

README

Reactions for Eloquent models: configured types, free-form emoji, single or multiple mode.

Installation

composer require pharaonic/laravel-reacts
php artisan migrate

The service provider is registered automatically, and migrate creates the reactions table. Publish the configuration to define your own reaction types and groups:

php artisan vendor:publish --tag=reacts-config

Usage

Add CanReact to the model that reacts and HasReactions to the model that receives reactions:

use Illuminate\Foundation\Auth\User as Authenticatable;
use Pharaonic\Laravel\Reacts\Concerns\CanReact;

class User extends Authenticatable
{
    use CanReact;
}

use Illuminate\Database\Eloquent\Model;
use Pharaonic\Laravel\Reacts\Concerns\HasReactions;

class Post extends Model
{
    use HasReactions;
}

use Pharaonic\Laravel\Reacts\Support\ReactionView;

$user->react($post, 'like');            // true: added
$user->react($post, 'love');            // true: a second type (multiple mode, the default)
$user->react($post, 'love');            // false: already there
$user->toggleReaction($post, 'like');   // false: removed
$user->hasReacted($post, 'love');       // true
$user->react($chatMessage, '🚀');        // true: in a group that allows free-form emoji

$post->reactionCounts();                // ['love' => 1]
ReactionView::for($post, $user)->toArray(); // choices, counts and the viewer's selection, for Blade or JSON

Documentation

Full documentation: Laravel Reacts Documentation.

Support & Security

See SUPPORT.md and SECURITY.md. Contributions are welcome; see CONTRIBUTING.md.

License

MIT. See LICENSE.