PHPackages                             ahmedkandel/nova-checklist - 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. [Utility & Helpers](/categories/utility)
4. /
5. ahmedkandel/nova-checklist

ActiveLibrary[Utility & Helpers](/categories/utility)

ahmedkandel/nova-checklist
==========================

A Laravel Nova field to display a list of items to complete.

v3.0.0(4y ago)110MITVue

Since Jan 30Pushed 4y agoCompare

[ Source](https://github.com/ahmedkandel/nova-checklist)[ Packagist](https://packagist.org/packages/ahmedkandel/nova-checklist)[ RSS](/packages/ahmedkandel-nova-checklist/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Laravel Nova Checklist Field
============================

[](#laravel-nova-checklist-field)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c6d37dccbaca84be1e64a0090a05e2e0b075ba39273aa319aa3eab748dd597c5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61686d65646b616e64656c2f6e6f76612d636865636b6c6973742e737667)](https://packagist.org/packages/ahmedkandel/nova-checklist)[![License](https://camo.githubusercontent.com/bf88d22ae2e30994b6161dcd71474bc1a99ec3391f1caea2cd5a4fa42ec9206c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f61686d65646b616e64656c2f6e6f76612d636865636b6c6973742e737667)](https://packagist.org/packages/ahmedkandel/nova-checklist)[![Total Downloads](https://camo.githubusercontent.com/8442230a3a5739149794f85ee2b2a0bc960a9ef814783bbb1e0fc5571bfe8e82/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61686d65646b616e64656c2f6e6f76612d636865636b6c6973742e737667)](https://packagist.org/packages/ahmedkandel/nova-checklist)

Based on [encima-io/novachecklists](https://github.com/encima-io/novachecklists)

This package is made to allow you to easily create checklists in Laravel Nova. All you need is a text/json column on you model to store the items.

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

[](#installation)

You can install the package via composer:

```
composer require ahmedkandel/nova-checklist
```

Usage
-----

[](#usage)

```
use Ahmedkandel\NovaChecklist\Checklist;

Checklist::make('Tasks')
    ->placeholder('Add another task')   // Defaults to "Add item"
    ->placeholderCounter()              // Not active by default
    ->storeUserName()                   // Not active by default, accepts user-model column. Uses "name" when column isn't provided.
    ->showDetails()                     // Not active by default
    ->showItemStatusOnIndex()           // Not active by default
    ->showCompletionOnIndex(),          // Not active by default
```

To use this package you'll need a text or JSON column on you model to save the items, as they are persisted as json on your model.

### Form-page

[](#form-page)

The `->placeholder()` method allows you to specify your placeholder-text for the "add new item field".

The `->placeholderCounter()` method lets you show the item number when adding new item. If there is already 5 items, then it will say "Add item 6".

The `->storeUserName()` method allows you to save which user created or completed the item. You specify which column on the User model you want to save on item, it default to use the "name" column.

The `->canEdit()` method can be used to allow/disallow add/edit/delete items. By passing a boolean of closure to the method, If true the user can add/edit/delete items, If false the user can only check/uncheck items.

```
->canEdit(function ($request) {
    return $request->isCreateOrAttachRequest() || $request->user()->isAdmin();
})
```

[![Checklist-form-page](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/form-add.png)](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/form-add.png)

You can edit an existing item by clicking on it unless it is not allowed by `->canEdit()` method.

[![Checklist-form-page](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/form-edit.png)](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/form-edit.png)

### Detail-page

[](#detail-page)

The `->showDetails()` method lets you show who completed the item and how long ago it was completed.

[![Checklist-detail-page](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/detail.png)](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/detail.png)

### Index-page

[](#index-page)

By default this package will only show the items count on the index page.

The `->showItemStatusOnIndex()` will change the index to show how many items are completed of the total amount of items.

The `->showCompletionOnIndex()` method will let you show how many percent of the items are completed.

When you click on the label a tooltip will all details will be shown.

[![Checklist-detail-page](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/index.png)](https://raw.githubusercontent.com/ahmedkandel/nova-checklist/master/index.png)

License
-------

[](#license)

The MIT License (MIT).

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~1 days

Total

3

Last Release

1557d ago

Major Versions

v1.0.0 → v2.0.02022-02-02

v2.0.0 → v3.0.02022-02-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/1abf5035e0b0bdab563de903ddc5c22de235eafed01ebc5653e6e1eb7a3a44e0?d=identicon)[sa@tomorrowsystem.com](/maintainers/sa@tomorrowsystem.com)

---

Top Contributors

[![ahmedkandel](https://avatars.githubusercontent.com/u/28398523?v=4)](https://github.com/ahmedkandel "ahmedkandel (4 commits)")

---

Tags

laravelnovachecklistschecklist

### Embed Badge

![Health badge](/badges/ahmedkandel-nova-checklist/health.svg)

```
[![Health](https://phpackages.com/badges/ahmedkandel-nova-checklist/health.svg)](https://phpackages.com/packages/ahmedkandel-nova-checklist)
```

###  Alternatives

[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)[optimistdigital/nova-multiselect-field

A multiple select field for Laravel Nova.

3403.5M7](/packages/optimistdigital-nova-multiselect-field)[digital-creative/conditional-container

Provides an easy way to conditionally show and hide fields in your Nova resources.

116593.8k4](/packages/digital-creative-conditional-container)[sbine/route-viewer

A Laravel Nova tool to view your registered routes.

57215.9k](/packages/sbine-route-viewer)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

14720.0k](/packages/markwalet-nova-modal-response)

PHPackages © 2026

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