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
    }
}