AdonisJS

This guide covers adding debugger to an AdonisJS project. The setup takes two steps.

Feature	Support
Server console	Yes
Server errors	Yes
HTTP requests	Yes
Browser script injection	Manual

Install

npm install -D @ephem-sh/debugger

1. Create the middleware

Create app/middleware/debugger_middleware.ts:

import { initDebugger, DebuggerMiddleware as Base } from '@ephem-sh/debugger/adonis'
import type { HttpContext } from '@adonisjs/core/http'
import type { NextFn } from '@adonisjs/core/types/http'

initDebugger({ port: 3333 })

const base = new Base()

export default class DebuggerMiddleware {
  async handle(ctx: HttpContext, next: NextFn) {
    return base.handle(ctx, next)
  }
}

2. Register as global middleware

In start/kernel.ts, add the middleware as the first entry in server.use():

server.use([
  () => import('#middleware/debugger_middleware'),
  // ... other middleware
])

Placing it first ensures it intercepts /_/d.js and /_/d before other middleware runs.

Browser support

Add script tags before </body> in your Edge layout template (for example, resources/views/components/layout.edge):

<script>window.__DEBUGGER_INGEST_URL__="/_/d";</script>
<script src="/_/d.js" defer></script>

Verify

node ace serve --hmr

npmpnpmbunyarn

npx dbg status

pnpm dlx dbg status

bun x dbg status

yarn dlx dbg status