README

EloquentLens

A visual dashboard for your Laravel Eloquent models.
Relationships, scopes, casts, policies, complexity — all at a glance. No database queries.

composer require khomerikik/eloquent-lens --dev
php artisan eloquent-lens:install

Add to your .env to enable the dashboard:

ELOQUENT_LENS_ENABLED=true

Then open /eloquent-lens in your browser.

Dev only — install with --dev. The dashboard is disabled by default and must be explicitly enabled.

Published to config/eloquent-lens.php after running eloquent-lens:install:

Option	Default	Description
`path`	`'eloquent-lens'`	URL prefix — dashboard is available at `/{path}`
`middleware`	`['web']`	Route middleware — add `'auth'` to restrict access
`model_paths`	`[app_path('Models')]`	Directories to scan for model files
`model_namespace`	`'App\\Models'`	Base namespace for your models
`excluded_models`	`[]`	Model classes to skip during scanning
`enabled`	`false`	Disabled by default — set `ELOQUENT_LENS_ENABLED=true` in `.env` to enable

All your models laid out as cards, connected by relationship lines. Drag, zoom, filter by type.

Click any model to open a side panel with four tabs:

Overview — traits, casts, accessors, fillable fields, complexity score

Relations — every relationship with its type and target model

Behavior — local scopes, global scopes, observers, custom methods

Pick two models and discover how they connect through relationships, up to 5 hops deep.

MIT