Frameworks that work

Rack

require "better_errors"

if ENV["RACK_ENV"] == "development"
  use BetterErrors::Middleware
end

Hanami

better_errors is included with hanami-webconsole, and works out of the box without changes.

Sinatra

Add the following to the top of your Sinatra application:

require "better_errors"

configure :development do
  use BetterErrors::Middleware
  BetterErrors.application_root = __dir__
end

Frameworks with issues

There is currently a bug that keeps context information from loading using Middleman.

Shotgun

Shotgun causes every request to load all dependencies, including Better Errors. Better Errors relies on storing the most recent exception in memory, and Shotgun makes this impossible.

The solution is to remove shotgun from your project. One alternative is rerun, which instead restarts the application only when files within the application change.