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:

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

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 in the initializer provided by the generator:

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

Error Messages

You can customize and add new errors to the translation file copied over by the initializer (config/locales/exceptionally_beautiful.en.yml).

I18n Gotcha

Make sure that all new error codes in your translation file are prefixed with a :. This is needed for I18n translation lookups to work properly when using keys that are integers. See this for more information. e.g.

en:
  exceptionally_beautiful:
    default:
      title: "There's been an error"
      message: "Something has gone wrong. Please try again shortly."
    :401:
      title: "Unauthorized"
      message: "Leave and never come back!"

Markdown Formatting

The message for each error can be formatted using Markdown. e.g.

  exceptionally_beautiful:
    default:
      title: "There's been an error"
      message: |
        Something has **gone wrong**. Please try again shortly.

        Or just go [back to our home page](/)...

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

Inspiration & Alternatives

This is by no means the first library to tackle this problem. Check out these other alternatives before deciding what to use.

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Running tests

bundle exec guard