Web UI

The debug Web UI is an HTTP handler that renders the same scope tree and dependency graph as do.ExplainInjector, but as a browsable page instead of a text dump. Mount it on any router — the standard library, Gin, Fiber, Echo, or Chi are all supported.

Once mounted, the handler serves the scope tree, per-service dependency details, and health-check status under the path prefix you choose (/debug/do in the examples below). It's a thin read-only layer over the same ExplainInjector / ExplainService APIs used for text-based debugging — useful when you'd rather click through a running instance than reproduce the issue with a script.

Caution

Do not expose the debug Web UI publicly in production. It reveals internal information about your DI graph (service names, dependencies, etc.). Protect the routes with authentication (for example, Basic Auth) and/or network restrictions (IP allowlist, VPN). Apply your auth middleware to the router group before mounting the debug handlers.

Without framework

go get github.com/samber/do/http/std/v2

import "github.com/samber/do/http/std/v2"

injector := startProgram()

mux := http.NewServeMux()
// Protect with your own middleware (e.g., Basic Auth) before mounting
// the debug handler in production.
mux.Handle("/debug/do/", std.Use("/debug/do", injector))

http.ListenAndServe(":8080", mux)

Gin

go get github.com/samber/do/http/gin/v2

import "github.com/samber/do/http/gin/v2"

injector := startProgram()

router := gin.New()
// Attach auth middleware to the group to protect debug UI in production.
ginhttp.Use(router.Group("/debug/do"), injector)

router.Run(":8080")

Fiber

go get github.com/samber/do/http/fiber/v2

import "github.com/samber/do/http/fiber/v2"

injector := startProgram()

router := fiber.New()
// Attach auth middleware to the group to protect debug UI in production.
fiberhttp.Use(router.Group("/debug/do"), "/debug/do", injector)

router.Listen(":8080")

Echo

go get github.com/samber/do/http/echo/v2

import "github.com/samber/do/http/echo/v2"

injector := startProgram()

router := echo.New()
// Attach auth middleware to the group to protect debug UI in production.
echohttp.Use(router.Group("/debug/do"), "/debug/do", injector)

router.Start(":8080")

Chi

go get github.com/samber/do/http/chi/v2

import "github.com/samber/do/http/chi/v2"

injector := startProgram()

router := chi.NewRouter()
// Protect with your own middleware (e.g., Basic Auth) before mounting
// the debug handler in production.
chihttp.Use(router, "/debug/do", injector)

http.ListenAndServe(":8080", router)