PHPackages                             mlusas/laravel-loom-updates - 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. mlusas/laravel-loom-updates

ActiveLibrary

mlusas/laravel-loom-updates
===========================

A Laravel package for tracking Loom video updates in your codebase

v1.0.4(1y ago)2105GPL-3.0-or-laterPHPPHP ^8.1

Since Sep 28Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mlusas/laravel-loom-updates)[ Packagist](https://packagist.org/packages/mlusas/laravel-loom-updates)[ RSS](/packages/mlusas-laravel-loom-updates/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (6)Used By (0)

Laravel Loom Updates
====================

[](#laravel-loom-updates)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b6a2f3e82ab68688bfe7d5a9ae3b015ffeefd4cb279f0d3286fb976663254de4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6c757361732f6c61726176656c2d6c6f6f6d2d757064617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mlusas/laravel-loom-updates)[![Total Downloads](https://camo.githubusercontent.com/97ca01f9bb08bd49afa7ea704e655e68dd71c5c324aefe041c3aae15d6f6eb8b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6c757361732f6c61726176656c2d6c6f6f6d2d757064617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mlusas/laravel-loom-updates)[![License](https://camo.githubusercontent.com/36c070ae631caa2bb4c53402e2bee19e772e15af61741b572b628288dfa778e0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6c757361732f6c61726176656c2d6c6f6f6d2d757064617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mlusas/laravel-loom-updates)

Who is this for?
----------------

[](#who-is-this-for)

Laravel Loom Updates is designed for Laravel developers who:

- Want to enhance their code documentation with video explanations
- Need to manage and track Loom videos used throughout their codebase
- Aim to improve onboarding processes for new team members
- Desire a centralized way to view and manage code-related video content

If you're using Loom to create video explanations for your code and want an easy way to manage these videos within your Laravel project, this package is for you!

[Jump to use cases](#use-cases)

What is Laravel Loom Updates?
-----------------------------

[](#what-is-laravel-loom-updates)

Laravel Loom Updates is a package that helps you track and manage Loom video links in your Laravel project's codebase. It provides tools to scan your code for Loom URLs, store them in a database, and display them in a user-friendly interface.

Features
--------

[](#features)

- Scan your Laravel project for Loom video URLs
- Option to see list of Loom videos in Command Line or Web Browser
- Store Loom video metadata in your database
- Display Loom videos in a clean, responsive interface
- Artisan commands for easy management of Loom URLs
- Configurable file scanning options

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

[](#installation)

You can install the package via composer:

```
composer require mlusas/laravel-loom-updates
```

After installation, run the migrations to create the necessary database table:

```
php artisan migrate
```

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

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --provider="mlusas\LaravelLoomUpdates\LoomUpdatesServiceProvider" --tag="config"
```

This will create a `config/loom-updates.php` file where you can modify the package settings:

```
return [
    'use_database' => true,
    'scan_directories' => [
        app_path(),
        resource_path(),
    ],
    'file_extensions' => ['php', 'js', 'ts', 'vue'],
];
```

- `use_database`: Set to `true` to store Loom URLs in the database, or `false` to only scan files without storing.
- `scan_directories`: An array of directories to scan for Loom URLs.
- `file_extensions`: An array of file extensions to scan for Loom URLs.

Usage
-----

[](#usage)

### Adding Loom URLs to Your Code

[](#adding-loom-urls-to-your-code)

You can add Loom URLs to your code using the following format:

```
/**
 * @loom https://www.loom.com/share/your-video-id YYYY-MM-DD author "new Feature"
 */
```

- `YYYY-MM-DD`: The date the video was created
- `author`: The name of the person who created the video
- `tag`: A custom tag for categorizing the video (optional, enclosed in double quotes)

Example:

```
/**
 * @loom https://www.loom.com/share/1234567890abcdef 2023-09-27 John.Doe "bug"
 */
class ComplexAlgorithm
{
    // ...
}
```

### Scanning for Loom URLs

[](#scanning-for-loom-urls)

To scan your project for Loom URLs and store them in the database (if `use_database` is true), run:

```
php artisan loom:store
```

### Listing Loom URLs

[](#listing-loom-urls)

To list all Loom URLs found in your codebase, use:

```
php artisan loom:list
```

You can also filter by timeframe:

```
php artisan loom:list --timeframe=week
```

Timeframe options include:

- "day"
- "week"
- "month"

Note: This command will always scan your files in real-time. If `use_database` is set to `true`, it will also check the database for any stored URLs.

The output will include the URL, file path, line number, author, date, and tag for each Loom URL found.

### Viewing Loom Videos

[](#viewing-loom-videos)

To view the Loom videos in a web interface, add the following route to your `routes/web.php` file:

```
Route::get('/loom-videos', function () {
    $loomUrls = \mlusas\LaravelLoomUpdates\Models\LoomUrl::all();
    return view('loom-updates::loom-viewer', compact('loomUrls'));
})->name('loom-videos');
```

Then visit `/loom-videos` in your browser.

*Tip: include the `loom:store` command in your CI/CD to scan, store, and show changes when pushed to staging or production.*

Here's a preview of what the Loom viewer interface looks like:

[![Loom Viewer Interface](./assets/example-LaravelLoomUpdate_interface_2.jpg)](./assets/example-LaravelLoomUpdate_interface_2.jpg)

Use Cases
---------

[](#use-cases)

1. **Code Documentation**: Explain complex parts of your codebase with Loom videos.
2. **Onboarding New Developers**: Help new team members understand the codebase quickly.
3. **Feature Demonstrations**: Demonstrate new features or changes in the project.
4. **Bug Reporting**: Visually report and explain bugs in the system.
5. **Code Review Explanations**: Provide detailed explanations for code reviews.
6. **Architecture Overviews**: Give high-level explanations of system architecture.

[Back to top](#laravel-loom-updates)

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

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

### Testing

[](#testing)

```
composer test
```

Security
--------

[](#security)

If you discover any security-related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Mitch Lusas](https://github.com/mlusas)
- [All Contributors](../../contributors)

License
-------

[](#license)

The GNU General Public License v3.0 (GPLv3). Please see [License File](LICENSE.md) for more information.

###  Health Score

29

—

LowBetter than 62% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

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

Total

5

Last Release

541d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/55a256f6965a23f0ec2b2aa97284bb2c8e6b4a1722e191978950b061927bb575?d=identicon)[mlusas](/maintainers/mlusas)

---

Top Contributors

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

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mlusas-laravel-loom-updates/health.svg)

```
[![Health](https://phpackages.com/badges/mlusas-laravel-loom-updates/health.svg)](https://phpackages.com/packages/mlusas-laravel-loom-updates)
```

###  Alternatives

[behamin/service-proxy

for proxy or sending requests to other services with useful utilities

102.2k](/packages/behamin-service-proxy)

PHPackages © 2026

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