PHPackages                             sinarahmany/laravel-dump-mac-viewer - 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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. sinarahmany/laravel-dump-mac-viewer

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

sinarahmany/laravel-dump-mac-viewer
===================================

Zero-configuration Laravel dump integration for macOS Laravel Dump Viewer

v1.0.3(6mo ago)14MITPHPPHP ^8.0

Since Oct 25Pushed 6mo agoCompare

[ Source](https://github.com/sinarahmany/laravel-dump-mac-viewer)[ Packagist](https://packagist.org/packages/sinarahmany/laravel-dump-mac-viewer)[ Docs](https://github.com/sinarahmany/laravel-dump)[ RSS](/packages/sinarahmany-laravel-dump-mac-viewer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

Laravel Dump macOS Viewer - Composer Package
============================================

[](#laravel-dump-macos-viewer---composer-package)

A zero-configuration Laravel package that integrates with the Laravel Dump macOS Viewer app for real-time debugging.

🚀 Features
----------

[](#-features)

- **Zero Configuration** - Works out of the box
- **Auto-Detection** - Automatically finds the macOS app
- **Multiple Functions** - `app_dump()`, `app_dd()`, `app_var_dump()`, `app_print_r()`
- **Smart Fallback** - Graceful handling when macOS app isn't running
- **Laravel Integration** - Works in routes, controllers, models, commands

📦 Installation
--------------

[](#-installation)

### Option 1: Composer Package (Recommended)

[](#option-1-composer-package-recommended)

```
composer require sinarahmany/laravel-dump-mac-viewer --dev
php artisan laravel-dump:setup
```

### Option 2: Automated Installer

[](#option-2-automated-installer)

```
curl -sSL https://raw.githubusercontent.com/sinarahmany/laravel-dump/main/install.sh | bash
```

### Option 3: Manual Setup

[](#option-3-manual-setup)

```
curl -sSL https://raw.githubusercontent.com/sinarahmany/laravel-dump/main/setup-laravel-dump.php | php
```

🎮 Usage
-------

[](#-usage)

After installation, these functions are immediately available:

```
// In any Laravel file (routes, controllers, models, etc.)
app_dump($data);           // Dump to macOS app
app_dd($data);            // Dump and die
app_var_dump($data);      // Var dump
app_print_r($data);       // Print_r

// Examples
app_dump(['user' => 'John', 'age' => 30]);
app_dd($request->all());
```

🧪 Testing
---------

[](#-testing)

1. **Start your Laravel server**:

```
php artisan serve
```

2. **Visit test URLs**:

- `http://localhost:8000/test-dump` - Simple dump test
- `http://localhost:8000/test-complex` - Complex data test

3. **Start your macOS Laravel Dump app** and watch the dumps appear!

🔧 Configuration
---------------

[](#-configuration)

The package works with zero configuration, but you can customize it:

```
php artisan vendor:publish --tag=laravel-dump-config
```

Then edit `config/laravel-dump.php`:

```
return [
    'server_url' => 'http://localhost:9999',  // Custom server URL
    'auto_detect' => true,                   // Auto-detect macOS app
    'enabled' => true,                       // Enable/disable integration
    'ports' => [9999, 9998, 9997],         // Ports to check
    'timeout' => 1,                         // Request timeout
];
```

🌍 Environment Variables
-----------------------

[](#-environment-variables)

```
LARAVEL_DUMP_SERVER_URL=http://localhost:9999
LARAVEL_DUMP_AUTO_DETECT=true
LARAVEL_DUMP_ENABLED=true
LARAVEL_DUMP_TIMEOUT=1
```

📋 Requirements
--------------

[](#-requirements)

- PHP 8.0+
- Laravel 9.0+
- macOS Laravel Dump Viewer app

🎯 How It Works
--------------

[](#-how-it-works)

1. **Auto-Detection**: Automatically finds the macOS app on ports 9999, 9998, 9997
2. **Zero Configuration**: No manual setup required
3. **Smart Fallback**: Graceful handling when app isn't running
4. **Performance**: 1-second timeout to avoid blocking your app

🚀 Quick Start
-------------

[](#-quick-start)

```
# Install the package
composer require sinarahmany/laravel-dump-mac-viewer --dev

# Run setup (optional)
php artisan laravel-dump:setup

# Start using immediately
app_dump('Hello from Laravel!');
```

📖 Documentation
---------------

[](#-documentation)

- [Full Documentation](https://github.com/sinarahmany/laravel-dump)
- [macOS App Repository](https://github.com/sinarahmany/laravel-dump-macos)

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License
---------

[](#-license)

This project is open source and available under the [MIT License](LICENSE).

👨‍💻 Author
----------

[](#‍-author)

**Sina Rahmannejad**

- GitHub: [@sinarahmany](https://github.com/sinarahmany)
- Website: [sinarahmannejad.com](https://sinarahmannejad.com)
- LinkedIn: [sina-rahmannejad](https://linkedin.com/in/sina-rahmannejad)

🙏 Acknowledgments
-----------------

[](#-acknowledgments)

- Laravel Framework
- macOS Development Community
- Open Source Contributors

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance66

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

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

4

Last Release

199d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2c78045f17c830e800fd0c78068d956aea64a0051cc8c0cca9a88f2195be85ca?d=identicon)[sinarahmany](/maintainers/sinarahmany)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/sinarahmany-laravel-dump-mac-viewer/health.svg)

```
[![Health](https://phpackages.com/badges/sinarahmany-laravel-dump-mac-viewer/health.svg)](https://phpackages.com/packages/sinarahmany-laravel-dump-mac-viewer)
```

###  Alternatives

[fruitcake/laravel-telescope-toolbar

Toolbar for Laravel Telescope based on Symfony Web Profiler

8041.6M3](/packages/fruitcake-laravel-telescope-toolbar)[laracraft-tech/laravel-xhprof

Easy XHProf setup to profile your laravel application!

235321.4k](/packages/laracraft-tech-laravel-xhprof)[spatie/laravel-artisan-dd

Run dd from your commandline

16387.7k1](/packages/spatie-laravel-artisan-dd)[bavix/laravel-xhprof

Quick profiling of your code for Laravel

22156.6k](/packages/bavix-laravel-xhprof)[daylerees/anbu

The Anbu profiler for Laravel 4.

3054.9k](/packages/daylerees-anbu)[thehocinesaad/laravel-error-ai

This package adds Ask AI button to the error page.

2214.4k](/packages/thehocinesaad-laravel-error-ai)

PHPackages © 2026

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