PHPackages                             alphaolomi/laravel-notes - 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 &amp; Helpers](/categories/utility)
4. /
5. alphaolomi/laravel-notes

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

alphaolomi/laravel-notes
========================

Add Notes to your models for Laravel.

v0.2.0(2y ago)1153[6 PRs](https://github.com/alphaolomi/laravel-notes/pulls)MITPHPPHP ^8.1CI passing

Since Jun 30Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/alphaolomi/laravel-notes)[ Packagist](https://packagist.org/packages/alphaolomi/laravel-notes)[ Docs](https://github.com/alphaolomi/laravel-notes)[ RSS](/packages/alphaolomi-laravel-notes/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (14)Versions (12)Used By (0)

A minimal notes package for Laravel.
====================================

[](#a-minimal-notes-package-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/982271165aff3c6e16001f08eddcef158a38a179c5eb4b5703c61fc86bb72f0b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c7068616f6c6f6d692f6c61726176656c2d6e6f7465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alphaolomi/laravel-notes)[![GitHub Tests Action Status](https://camo.githubusercontent.com/957e415532b74982fd72b6a485b4117843f3e88226ca4b9245814d743ce60dbb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c7068616f6c6f6d692f6c61726176656c2d6e6f7465732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/alphaolomi/laravel-notes/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/d163a32ed3e9b107434af98869cb87a7f9e38b8ef435f7291bbffb4c6b4a3f5b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616c7068616f6c6f6d692f6c61726176656c2d6e6f7465732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/alphaolomi/laravel-notes/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/678337c2e22b3855759e57027c219d01dcc018164d5f6974ff607d065c18087e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616c7068616f6c6f6d692f6c61726176656c2d6e6f7465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/alphaolomi/laravel-notes)Add Notes to your models in your Laravel Applications.

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

[](#installation)

You can install the package via composer:

```
composer require alphaolomi/laravel-notes
```

You can publish and run the migrations with:

```
php artisan vendor:publish --tag="notes-migrations"
php artisan migrate
```

You can publish the config file with:

```
php artisan vendor:publish --tag="notes-config"
```

This is the contents of the published config file:

```
return [
    'model' => \AlphaOlomi\Notes\Models\Note::class,

    'user' => \App\Models\User::class,

];
```

Usage
-----

[](#usage)

Start by using the `AlphaOlomi\Notes\Concerns\HasNotes` trait on your model.

```
use AlphaOlomi\Notes\Concerns\HasNotes;

class Project extends Model
{
    use HasNotes;
}
```

This trait adds a `notes(): MorphMany` relationship on your model. It also adds a new `Note()` method that can be used to quickly add a Note to your model.

```
$project = Project::first();

$project->addNote('This is a note.');
```

By default, the package will use the authenticated user's ID as the "Noter". You can customize this by providing a custom `User` to the `Note()` method.

```
$project->addNote('This ia a another note.', user: User::first());
```

The package also supports `parent -> children` relationships for notes. This means that a Note can `belongTo` another Note.

```
$project->addNote('Thanks you!', parent: Note::find(2));
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Alpha Olomi](https://github.com/alphaolomi)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance61

Regular maintenance activity

Popularity10

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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 ~109 days

Total

5

Last Release

972d ago

Major Versions

v0.1.1 → 1.x-dev2023-07-12

1.x-dev → 2.x-dev2023-07-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/7534dd7341d883267be41935354b56c27f94d6bbd6a7abd9f257bb2d494a3798?d=identicon)[alphao](/maintainers/alphao)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 commits)")[![alphaolomi](https://avatars.githubusercontent.com/u/10551599?v=4)](https://github.com/alphaolomi "alphaolomi (8 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")

---

Tags

laravellaravel-notesnotesphplaravelnotesalphaolomilaravel-notes

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/alphaolomi-laravel-notes/health.svg)

```
[![Health](https://phpackages.com/badges/alphaolomi-laravel-notes/health.svg)](https://phpackages.com/packages/alphaolomi-laravel-notes)
```

###  Alternatives

[spatie/laravel-data

Create unified resources and data transfer objects

1.7k28.9M626](/packages/spatie-laravel-data)[hirethunk/verbs

An event sourcing package that feels nice.

513162.9k6](/packages/hirethunk-verbs)[laracraft-tech/laravel-useful-additions

A collection of useful Laravel additions!

58109.4k](/packages/laracraft-tech-laravel-useful-additions)[worksome/exchange

Check Exchange Rates for any currency in Laravel.

123544.7k](/packages/worksome-exchange)[ralphjsmit/livewire-urls

Get the previous and current url in Livewire.

82270.3k4](/packages/ralphjsmit-livewire-urls)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

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