Exceptionally Beautiful

A Rails engine for handling error pages.

Setup

Getting up-and-running is simple. Just use the built-in generator:

bundle exec rails g exceptionally_beautiful:install

The generator will:

• Add the route helper to config/routes.rb
• Add an initializer that you can customize in config/initializers/exceptionally_beautiful.rb
• Copy over the translation data to config/locales/exceptionally_beautiful.en.yml

What You Get

Exceptionally Beautiful will handle any three-digit status code you throw at it. It comes with translation data for the following common errors:

Error	Code
Forbidden	403
Not Found	404
Unprocessable Entity	422
Internal Server Error	500
Bad Gateway	502

Any status code that is either unrecognized or missing translation data will fall back to default messaging.

Customizing

If the default controller, action, and/or layout don't suit your fancy, you can override any of them:

ExceptionallyBeautiful.setup do |config|
  config.layout = 'errors'
  config.controller = 'exceptionally_beautiful/errors'
  config.action = 'show'
end

Usage With rescue_from

If you're using Rails' rescue_from functionality, you can still use Exceptionally Beautiful:

class ApplicationController < ActionController::Base
  include ExceptionallyBeautiful::ErrorHandler

  rescue_from Mongoid::Errors::DocumentNotFound do |exception|
    error_handler(404)
  end
end