PHPackages                             albertgrala/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. albertgrala/notes

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

albertgrala/notes
=================

Easy Notes Management for Laravel 4.

v0.11(13y ago)214PHPPHP &gt;=5.3.0

Since Feb 26Pushed 13y ago1 watchersCompare

[ Source](https://github.com/albertgrala/notes)[ Packagist](https://packagist.org/packages/albertgrala/notes)[ RSS](/packages/albertgrala-notes/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

Notes
=====

[](#notes)

Notes helps you manage your notes when developing an application

By default the information is stored in a json file **notes.json** in the project root.

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

[](#installation)

- Update your composer.json to require `"albertgrala/notes": "dev-master"` .

```
{
  "require": {
    "laravel/framework": "4.0.*",
    "albertgrala/notes": "dev-master"
  },
  "autoload": {
    "classmap": [
      "app/commands",
      "app/controllers",
      "app/models",
      "app/database/migrations",
      "app/database/seeds",
      "app/tests/TestCase.php"
    ]
  },
  "minimum-stability": "dev"
}
```

- Run `composer update` in the Terminal
- Add the NotesServiceProvider `'Albertgrala\Notes\NotesServiceProvider'` to the laravel providers array in the file `app/config/app.php`

```
'providers' => array(

    'Illuminate\Foundation\Providers\ArtisanServiceProvider',
    'Illuminate\Auth\AuthServiceProvider',
    'Illuminate\Cache\CacheServiceProvider',
    'Illuminate\Foundation\Providers\CommandCreatorServiceProvider',
    'Illuminate\Session\CommandsServiceProvider',
    'Illuminate\Foundation\Providers\ComposerServiceProvider',
    'Illuminate\Routing\ControllerServiceProvider',
    'Illuminate\Cookie\CookieServiceProvider',
    'Illuminate\Database\DatabaseServiceProvider',
    'Illuminate\Encryption\EncryptionServiceProvider',
    'Illuminate\Filesystem\FilesystemServiceProvider',
    'Illuminate\Hashing\HashServiceProvider',
    'Illuminate\Foundation\Providers\KeyGeneratorServiceProvider',
    'Illuminate\Log\LogServiceProvider',
    'Illuminate\Mail\MailServiceProvider',
    'Illuminate\Database\MigrationServiceProvider',
    'Illuminate\Pagination\PaginationServiceProvider',
    'Illuminate\Foundation\Providers\PublisherServiceProvider',
    'Illuminate\Queue\QueueServiceProvider',
    'Illuminate\Redis\RedisServiceProvider',
    'Illuminate\Auth\Reminders\ReminderServiceProvider',
    'Illuminate\Database\SeedServiceProvider',
    'Illuminate\Foundation\Providers\ServerServiceProvider',
    'Illuminate\Session\SessionServiceProvider',
    'Illuminate\Foundation\Providers\TinkerServiceProvider',
    'Illuminate\Translation\TranslationServiceProvider',
    'Illuminate\Validation\ValidationServiceProvider',
    'Illuminate\View\ViewServiceProvider',
    'Illuminate\Workbench\WorkbenchServiceProvider',
    'Albertgrala\Notes\NotesServiceProvider',

  )

```

Commands
--------

[](#commands)

You can see the `notes` commands typing `php artisan` in the Terminal

CommandDescriptionArgumentsOptions`notes:add`Add a new note to your notes file`type``notes:complete`Mark a note as done`id``notes:delete`Delete a note`id``all``notes:show`LList the notes`type``all` , `done` , `today`### notes:add

[](#notesadd)

The argument `type` is **required**. Once entered the command, the terminal will ask you to describe your note

```
php artisan notes:add todo
```

The note will be saved in the **notes.json** file. By default the `type` is converted to uppercase.

Examples of `type` : `todo` , `optimize` , `fixme` , `bug`

### notes:show

[](#notesshow)

To list your notes is as easy as typing `php artisan notes:show` , this will prompt all notes marked as uncompleted.

```
php artisan notes:show
```

You can filter your notes by `type` passing the argument. Use either the singular or plural form, uppercase or lowercase.

```
php artisan notes:show todo
php artisan notes:show todos
php artisan notes:show TODO
php artisan notes:show TODOS
```

#### Flags

[](#flags)

The `--all` flag will prompt the notes completed and uncompleted. In this example we will list all the bugs notes.

```
php artisan notes:show bugs --all
```

The `--done` flag will filter and prompt only the notes marked as completed.

```
php artisan notes:show todos --done
```

The `--today` flag will filter and prompt only the notes created today. In this example we will list all notes created today

```
php artisan notes:show --today
```

You can combine flags to filter even more.

```
php artisan notes:show todos --done --today
```

### notes:complete

[](#notescomplete)

Pass the note id to mark a note as completed. The note will be marked as done and the time saved as completed\_at

```
php artisan notes:complete 1
```

### notes:delete

[](#notesdelete)

Pass the note id to delete a note

```
php artisan notes:delete 5
```

You can delete all the notes passing the flag `--all`

```
php artisan notes:delete --all
```

Json file
---------

[](#json-file)

The **notes.json** has the following structure

```
{
  "notes":[
    {
      "id":1,
      "name":"Create the readme file",
      "type":"TODO",
      "done":true,
      "created_at":"2013-02-26 13:41:37",
      "completed_at":"2013-02-26 13:41:52"
    },
    {
      "id":2,
      "name":"Push notes changes to github",
      "type":"TODO",
      "done":true,
      "created_at":"2013-02-26 13:44:38",
      "completed_at":"2013-02-26 13:44:53"
    }
  ]
}
```

Screenshot
----------

[](#screenshot)

[![alt text](https://camo.githubusercontent.com/8b3a367933713c6d6ba8b2c9527954c13f97458799441e8fa47dff042cfdc751/68747470733a2f2f7261772e6769746875622e636f6d2f616c626572746772616c612f6e6f7465732f6d61737465722f73637265656e73686f742e676966 "Notes Screenshot")](https://camo.githubusercontent.com/8b3a367933713c6d6ba8b2c9527954c13f97458799441e8fa47dff042cfdc751/68747470733a2f2f7261772e6769746875622e636f6d2f616c626572746772616c612f6e6f7465732f6d61737465722f73637265656e73686f742e676966)

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

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

Unknown

Total

1

Last Release

4874d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9454aa11d85bbbe0523537275c608dc364096d8873abfff1cda77ff52fcdaa3e?d=identicon)[albertgrala](/maintainers/albertgrala)

---

Top Contributors

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

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M305](/packages/laravel-horizon)[livewire/flux

The official UI component library for Livewire.

9527.8M128](/packages/livewire-flux)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[spatie/laravel-flare

Send Laravel errors to Flare

111.4M7](/packages/spatie-laravel-flare)

PHPackages © 2026

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