synnode/telescope-eyepiece
| 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 |
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
HomeControllerreturnsview('telescope::layout'). The Eyepiece service provider prepends its own path on thetelescopeview namespace, so this package'sresources/views/layout.blade.phpwins 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 theGate::viewTelescopeauthorization 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
The operator console and orchestration layer for Laravel Horizon, built with Rea...
Production-safe, driver-agnostic dashboard for Laravel crons, queues and errors...
An elegant debug assistant for the Laravel framework compatible with mongodb.
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| v1.2.1 | ^8.1 | ^10.0| | MIT | |
| v1.2.0 | ^8.1 | ^10.0| | MIT | |
| v1.1.1 | ^8.1 | ^10.0| | MIT | |
| v1.1.0 | ^8.1 | ^10.0| | MIT | |
| v1.0.0 | ^8.1 | ^10.0| | MIT |