PHPackages                             mateusz-peczkowski/nova-heartbeat-resource-field - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mateusz-peczkowski/nova-heartbeat-resource-field

ActiveLibrary

mateusz-peczkowski/nova-heartbeat-resource-field
================================================

Heartbeat for resources to block editing same resource with 2 or more people

1.0.6(1y ago)33.5k↓50%MITPHPPHP >=8.0

Since Jun 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field)[ Packagist](https://packagist.org/packages/mateusz-peczkowski/nova-heartbeat-resource-field)[ RSS](/packages/mateusz-peczkowski-nova-heartbeat-resource-field/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (2)Versions (8)Used By (0)

[![NovaHeartbeatResourceField](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/raw/master/media/cover.jpeg?raw=true)](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/blob/master/media/cover.jpeg?raw=true)

Heartbeat Resource Field
========================

[](#heartbeat-resource-field)

This package provides a custom Nova field that will like heartbeat monitor watch who is editing currently the resource.

On a listing/details there will be information who is currently editing and as well another person will be blocked from editing the same resource to not overlap changes.

Package is made for Laravel Nova ^4 and it works as well with Laravel Nova ^5.

 [![](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/raw/master/media/img-1.png?raw=true)](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/blob/master/media/img-1.png?raw=true) [![](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/raw/master/media/img-2.png?raw=true)](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/blob/master/media/img-2.png?raw=true) [![](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/raw/master/media/img-3.png?raw=true)](https://github.com/mateusz-peczkowski/nova-heartbeat-resource-field/blob/master/media/img-3.png?raw=true)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require mateusz-peczkowski/nova-heartbeat-resource-field
```

### Migrations

[](#migrations)

After installation, you need to run the migration to create the table that will store the heartbeat data.

```
php artisan migrate
```

### Publish package (optional)

[](#publish-package-optional)

Publish the configuration file to customize the settings of the package (check bellow for more details).

```
php artisan vendor:publish --provider="MateuszPeczkowski\NovaHeartbeatResourceField\HeartbeatResourceServiceProvider"
```

Configuration
-------------

[](#configuration)

The package provides a configuration file that allows you to customize the settings of the package.

```
return [
    'table_name'            => 'nova_heartbeats',
    'heartbeat_model'       => \MateuszPeczkowski\NovaHeartbeatResourceField\Models\HeartbeatResource::class,
    'heartbeat_interval'    => env('NOVA_HEARTBEAT_INTERVAL', 5 * 1000), // 5 seconds
    'heartbeat_timeout'     => env('NOVA_HEARTBEAT_TIMEOUT', 60 * 1000), // 1 minute
    'heartbeat_guard'       => 'web',
    'heartbeat_guard_name'  => 'name',
    'heartbeat_guard_email' => 'email',
    'heartbeat_avatar_url'  => null,
];
```

Usage
-----

[](#usage)

### Nova Resource Field

[](#nova-resource-field)

To install this field in your Nova resource, you need to add the following code to the `fields` method of your resource.

```
use MateuszPeczkowski\NovaHeartbeatResourceField\NovaHeartbeatResourceField;

NovaHeartbeatResourceField::make('Heartbeat')
    ->resourceId($this->id),
```

Optionally you can allow to retake the resource by adding the following code

```
use MateuszPeczkowski\NovaHeartbeatResourceField\NovaHeartbeatResourceField;

NovaHeartbeatResourceField::make('Heartbeat')
    ->resourceId($this->id)
    ->allowRetake(),
```

Then on details view you will have additional button to retake the resource.

### Nova Resource Trait

[](#nova-resource-trait)

Add this trait to your Nova resource

```
use MateuszPeczkowski\NovaHeartbeatResourceField\Traits\HasNovaHeartbeats;

class YourResource extends Resource
{
    use HasNovaHeartbeats;
}
```

### Model Trait

[](#model-trait)

Add this trait to your Model

```
use MateuszPeczkowski\NovaHeartbeatResourceField\Traits\HasHeartbeats;

class YourModel extends Model
{
    use HasHeartbeats;
}
```

### Clearing expired heartbeats (recommended)

[](#clearing-expired-heartbeats-recommended)

In case of failure of removing the heartbeat, you can use the following command to remove all the heartbeats that are older than the timeout.

```
$schedule->command('heartbeat:clear-expired')->everyMinute();
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~29 days

Recently: every ~43 days

Total

7

Last Release

517d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cad64d66699c7a99f436394802c882fd2dd6abe798a5423c21ba8d8ae2b35e51?d=identicon)[mateusz-peczkowski](/maintainers/mateusz-peczkowski)

---

Tags

laravelfieldnovamateusz-peczkowski

### Embed Badge

![Health badge](/badges/mateusz-peczkowski-nova-heartbeat-resource-field/health.svg)

```
[![Health](https://phpackages.com/badges/mateusz-peczkowski-nova-heartbeat-resource-field/health.svg)](https://phpackages.com/packages/mateusz-peczkowski-nova-heartbeat-resource-field)
```

###  Alternatives

[whitecube/nova-flexible-content

Flexible Content & Repeater Fields for Laravel Nova.

8053.0M25](/packages/whitecube-nova-flexible-content)[optimistdigital/nova-sortable

This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop.

2872.1M6](/packages/optimistdigital-nova-sortable)[outl1ne/nova-sortable

This Laravel Nova package allows you to reorder models in a Nova resource's index view using drag & drop.

2861.8M9](/packages/outl1ne-nova-sortable)[outl1ne/nova-simple-repeatable

A Laravel Nova simple repeatable rows field.

74356.3k](/packages/outl1ne-nova-simple-repeatable)[optimistdigital/nova-simple-repeatable

A Laravel Nova simple repeatable rows field.

74151.2k](/packages/optimistdigital-nova-simple-repeatable)[optimistdigital/nova-notes-field

This Laravel Nova package adds a notes field to Nova's arsenal of fields.

52139.5k](/packages/optimistdigital-nova-notes-field)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)