pixielity/laravel-telescope

Laravel Telescope debugging with automatic watcher discovery for Pixielity applications

v1.0.0 2026-02-09 03:23 UTC

Requires

• php: ^8.5
• laravel/telescope: ^5.0
• pixielity/laravel-support: *

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

Suggests

• pixielity/laravel-telemetry-debugbar: For development debugging toolbar
• pixielity/laravel-telemetry-pulse: For real-time application monitoring
• pixielity/laravel-telemetry-sentry: For error tracking and monitoring

MIT

• Pixielity Team

• debugging
• monitoring
• laravel
• telemetry
• telescope
• observability
• pixielity

README

Laravel Telescope debugging with automatic watcher discovery for Pixielity applications.

📑 Table of Contents

• Overview
• Installation
• Features
• Attributes
  • AsWatcher
• Examples

🌟 Overview

The Telemetry Telescope package expands Laravel Telescope by adding automatic watcher discovery using PHP 8 attributes. This allows you to define custom watchers without manually editing the Telescope configuration.

📦 Installation

This package is included with the main pixielity/laravel-telemetry package. To install separately:

composer require pixielity/laravel-telemetry-telescope

✨ Features

• Automatic Watcher Discovery: Register custom Telescope watchers via #[AsWatcher].
• Easy Configuration: Set watcher properties directly in the attribute.
• Monorepo Ready: Scans your entire project for Telescope-related attributes.

🎯 Attributes

AsWatcher

Marks a class as a Telescope watcher for auto-discovery.

Properties:

• name: Unique identifier for the watcher.
• enabled: (default: true) Whether the watcher is active.
• priority: (default: 100) Registration priority.
• config: (default: []) Additional configuration options for the watcher.

💡 Examples

Check the .examples directory for real-world usage patterns.

Custom Watcher

use Pixielity\Telescope\Attributes\AsWatcher;

#[AsWatcher(name: 'analytics')]
class AnalyticsWatcher
{
    public function register($app): void
    {
        // Watcher registration logic
    }
}