New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

synnode/telescope-eyepiece

A reskin/redesign companion package for Laravel Telescope. Replaces the dashboard UI with a React SPA without modifying or forking the upstream package.
1,006
Install
composer require synnode/telescope-eyepiece
Latest Version:v1.2.1
PHP:^8.1
Laravel:10 – 13
License:MIT
Last Updated:Sep 22, 2026
Links: GitHub  ·  Packagist
Maintainer: unkn0wn

Telescope Eyepiece

A reskin/redesign companion package for Laravel Telescope. Replaces the default Vue dashboard with a custom React SPA, without modifying or forking Telescope itself.

How it works

  • Telescope's HomeController returns view('telescope::layout'). The Eyepiece service provider prepends its own path on the telescope view namespace, so this package's resources/views/layout.blade.php wins lookup.
  • The Eyepiece layout loads a pre-built React SPA (Vite) instead of Telescope's bundled Vue assets.
  • The React app consumes the existing /telescope-api/* JSON endpoints — recording, watchers, storage, and the Gate::viewTelescope authorization gate all keep working untouched.
  • A small eyepiece-api/* sidecar (two endpoints) adds entry counts for the sidebar and per-batch SQL counts for the Requests table.

Install

composer require synnode/telescope-eyepiece
php artisan vendor:publish --tag=eyepiece-assets

Visit /telescope (or whatever path you set in config/telescope.php) — it now serves the Eyepiece UI.

The package auto-discovers, no provider registration needed. Authorization keeps using your existing Gate::define('viewTelescope', …) from TelescopeServiceProvider.

Upgrading

Re-run vendor:publish --tag=eyepiece-assets --force after any version bump so the published assets and Vite manifest stay in sync with the installed package.

Develop

npm install
npm run dev      # Vite dev server on :5175, blade falls back to it when no manifest exists
npm run build    # production build into public/ (manifest.json + assets/)

The blade layout auto-detects: if public/.vite/manifest.json exists in the host app's public/eyepiece/ (post-vendor:publish), it serves built assets; otherwise it loads from http://localhost:5175.

For development against a real host app, add a path repo to the host's composer.json:

"repositories": [
    { "type": "path", "url": "/abs/path/to/telescope-eyepiece", "options": { "symlink": true } }
],
"require": {
    "synnode/telescope-eyepiece": "@dev"
}

Then run npm run dev from this package and load the host app normally — the symlinked source is picked up live, and Vite HMR works through the blade fallback.

Tests + lint

composer run test       # Pest, view-override regression
composer run analyse    # PHPStan level 4 on src/
npm run lint            # ESLint flat config across resources/js

Requirements

  • PHP 8.1+
  • Laravel 10 / 11 / 12 / 13
  • laravel/telescope ^5.0

License

MIT — see LICENSE.

Related Packages

lucianotonet/laravel-telescope-mcp

MCP Server extension for Laravel Telescope

59,935 23
devaction-labs/zenith

The operator console and orchestration layer for Laravel Horizon, built with Rea...

244 0
laravel/telescope

An elegant debug assistant for the Laravel framework.

92,473,850 5,237
devifyo/watchtower

Production-safe, driver-agnostic dashboard for Laravel crons, queues and errors...

9,115 72
yektadg/laravel-telescope-mongodb

An elegant debug assistant for the Laravel framework compatible with mongodb.

7,646 1

Version History

Version Released PHP Laravel License
v1.2.1 ^8.1 ^10.0|^11.0|^12.0|^13.0 MIT
v1.2.0 ^8.1 ^10.0|^11.0|^12.0|^13.0 MIT
v1.1.1 ^8.1 ^10.0|^11.0|^12.0|^13.0 MIT
v1.1.0 ^8.1 ^10.0|^11.0|^12.0|^13.0 MIT
v1.0.0 ^8.1 ^10.0|^11.0|^12.0|^13.0 MIT