Getting started

Install New Debug Bar

Add it to your Laravel app with one Composer command. Laravel discovers the package and the bar appears automatically while you work locally.

Install the package

Run this command from your Laravel app:

composer require --dev newdebugbar/newdebugbar:dev-main

Keep New Debug Bar in require-dev so production installs skip it.

Requirements

Before installing, make sure the app meets these requirements:

  • PHP 8.1 or newer.
  • Laravel 10 or newer.
  • A Laravel app running in its local environment.

Check that it works

Open any normal page in your app while Laravel is using the local environment. The bar should appear at the bottom of the browser.

New Debug Bar open over a Laravel page with request, query, and duration details
Open the compact bar to inspect the request, query count, duration, and other captured details.

Optional configuration

The defaults work without a config file. Publish one only when you need to change a setting:

php artisan vendor:publish --tag=newdebugbar-config

To leave the package installed but turn it off, add this to your .env file:

NEWDEBUGBAR_ENABLED=false

Troubleshooting

The bar does not appear
Confirm that Laravel reports the local environment and that NEWDEBUGBAR_ENABLED is not set to false. If your app uses another name for local work, publish the config and add that name to newdebugbar.environments. After changing config, run php artisan config:clear and refresh the page.
Composer reports a Livewire conflict

New Debug Bar requires Livewire 4. Apps that already depend on Livewire 3 are not supported yet, even though an app does not otherwise need to use Livewire itself. Ask Composer which dependency blocks Livewire 4:

composer why-not livewire/livewire ^4.1

Next step

Give your coding agent exact debug data

Connect the local MCP server so your agent can inspect saved request profiles instead of guessing from logs.

Open the MCP setup guide