Official BJCP Style Guide iOS application written in RubyMotion
Latest commit c09a7b6 May 11, 2017 @markrickert markrickert Update gems and pods

BJCP Style Guide (official)

App Icon

A RubyMotion application brought to you by Off The Grid Apps.

A full copy of the BJCP Style Guidelines always at the ready on your iOS device. Whether you're a beer judge, a homebrewer, or an enthusiast, this free app will come in handy whenever you want a quick lookup of a style description.

Download form the App Store


How to run the app from source:

  1. You must have a valid license of RubyMotion.
  2. Download the source code.
  3. Open a terminal and cd into the directory.
  4. Run bundle to install dependencies.
  5. Run rake to launch the app in the simulator.

Opening a style from another app:

BJCPStyles implements url schemes bjcpstyle:// and bjcp://. You can easily open the BJCPStyles app from Safari to automatically open a style by typing (as an example): bjcpstyle://3B which would launch the app and automatically open the 3B: Oktoberfest/Märzen style page.

For application developers:

You can check to see if the BJCPStyles app is installed by implementing:


- (BOOL)isBJCPStylesInstalled {
  NSURL *bjcpStylesURL = [NSURL URLWithString:@"bjcpstyle:"];
  return  [[UIApplication sharedApplication] canOpenURL:bjcpStylesURL];


def bjcpstyles_installed?
  bjcpstyles_url = NSURL.URLWithString "bjcpstyle:"
  UIApplication.sharedApplication.canOpenURL bjcpstyles_url

Then to actually call the app to open and go to a style:


- (void)openBJCPStyle(style) {
  NSURL *bjcpStylesURL = [NSURL URLWithString:[NString stringWithFormat:@"bjcpstyle://%@", style]];
  [[UIApplication sharedApplication] openURL:bjcpStylesURL];


def open_bjcpstyle(style)
  url = NSURL.URLWithString "bjcpstyle://#{style}"
  UIApplication.sharedApplication.openURL url


  1. Fork it.
  2. Work on a feature branch.
  3. Send me a pull request.

If you can't contribute but find an issue, please open an issue


It would be great to have the style guidelines translated into other languages. If you would like to contribute a translation, check out the /resources/en/ folder for the official SQLite database of styles, localized strings file, and content for the app.

You can copy those files into your own internationalized folder and make translations.

At a minimum, we need the following files translated:

  • SQLite database
  • Localized.strings

Once you've created that folder in the resources directory, send me a pull request!