PHPackages                             leuverink/magic-todo - 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. [Templating & Views](/categories/templating)
4. /
5. leuverink/magic-todo

ActiveLibrary[Templating & Views](/categories/templating)

leuverink/magic-todo
====================

Higlight TODO's inside your Blade templates

2.0.0(9mo ago)64.0kMITPHPPHP ^8.1CI passing

Since Aug 15Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/gwleuverink/magic-todo)[ Packagist](https://packagist.org/packages/leuverink/magic-todo)[ RSS](/packages/leuverink-magic-todo/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (11)Versions (7)Used By (0)

Magic todo
==========

[](#magic-todo)

[![codestyle](https://github.com/gwleuverink/magic-todo/actions/workflows/codestyle.yml/badge.svg)](https://github.com/gwleuverink/magic-todo/actions/workflows/codestyle.yml)[![tests](https://github.com/gwleuverink/magic-todo/actions/workflows/tests.yml/badge.svg)](https://github.com/gwleuverink/magic-todo/actions/workflows/tests.yml)

Magically turn HTML comments into interactive hints in your Laravel Blade frontend.

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

[](#installation)

```
composer require leuverink/magic-todo
```

Usage
-----

[](#usage)

Magic Todo turns your standard TODO comments in Blade files into interactive elements. By default, you can activate this feature by adding a pipe `|` symbol at the beginning of your comment.

```

  Some action

```

[![inline-comment-result](/resources/images/inline-comment-result.jpg)](/resources/images/inline-comment-result.jpg)

You can also highlight entire blocks of code:

```

  Some action

```

[![inline-comment-result](/resources/images/block-comment-result.jpg)](/resources/images/block-comment-result.jpg)

Blade comments are supported as well:

```
{{-- |TODO: This button is not yet implemented --}}
```

### Modifying TODO Keywords

[](#modifying-todo-keywords)

You can modify the default behavior by publishing the package config and editing the `magic-todo.open` & `magic-todo.close` keywords. For instance, changing `magic-todo.open` to `TODO` will highlight every todo comment in your templates.

If you change `magic-todo.open` to `TODO`, Every TODO comment in your template will be highlighted.

### Direct Component Usage

[](#direct-component-usage)

For more control, you can use the highlight component directly in your markup:

```

    Foo bar

            Do anything you like in here

```

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

[](#configuration)

```
[
    'enabled' => env('MAGIC_TODO_ENABLED', app()->isLocal()),
    'open' => 'TODO:',
    'close' => 'ENDTODO',
];
```

Development
-----------

[](#development)

```
composer lint # run all linters
composer fix # run all fixers

composer analyze # run static analysis
composer baseline # generate static analysis baseline

composer test # run test suite
composer build # bundle all assets
```

Ideas
-----

[](#ideas)

Here are some other features I have in mind if there is any interest in this package:

- Artisan command to list all todos (both in comments & direct component usage)
- Syntax for rendering in specific environments (e.g., only dev / dev + staging)
- Support for NOTE & FIXME comments with different styling
- Replace @mentions with clickable GitHub avatars
- Add better theme/styling support

License
-------

[](#license)

This package is open-source software licensed under the MIT license.

###  Health Score

40

—

FairBetter than 87% of packages

Maintenance61

Regular maintenance activity

Popularity27

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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

Total

5

Last Release

275d ago

Major Versions

1.2.1 → 2.0.02025-08-07

### Community

Maintainers

![](https://www.gravatar.com/avatar/9531bf1fdbe178d3a5129b81e61b70be81359ebf10ce3f282705a8275b4bd31d?d=identicon)[gwleuverink](/maintainers/gwleuverink)

---

Top Contributors

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

---

Tags

bladelaravel

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/leuverink-magic-todo/health.svg)

```
[![Health](https://phpackages.com/badges/leuverink-magic-todo/health.svg)](https://phpackages.com/packages/leuverink-magic-todo)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[illuminate/view

The Illuminate View package.

13144.9M1.7k](/packages/illuminate-view)[moonshine/moonshine

Laravel administration panel

1.3k217.1k59](/packages/moonshine-moonshine)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

703141.0k7](/packages/tallstackui-tallstackui)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[livewire/blaze

A tool for optimizing Blade component performance by folding them into parent templates

688221.3k17](/packages/livewire-blaze)

PHPackages © 2026

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