Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A sample app built with the Box Ruby SDK
Ruby JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib Fixed some comments.
public IE support for gradients and HTML 5 elements
views IE support for gradients and HTML 5 elements
Gemfile.lock Fix issue when a file name is taken
dashboard.rb Exception handling and placeholders

Box Sample App

Installation Guide

You need to register your Box application in order to get an API key. You can do that here.

While you're on that page, set your application's redirect url. This is the url the user is sent to after registering. It should be the address of your website, like "".

Running locally

You can run the sample app easy, you just need a few things.

First off, you need to have a copy of Ruby 1.9. Ruby 1.8 might work, but is losing support and is not what you will be running on your cloud provider.

With Ruby installed, use Bundler to install all of the project dependencies.

gem install bundler
cd <project root>

Lastly, you need to launch the Sinatra server. Prefix the command with your Box api key.

cd <project root>
export BOX_API_KEY=<your api key>

This will run the server on port 9292. Visit http://localhost:9292 to see your app in action.

Something went wrong with that request. Please try again.