A real-time, data-driven platform for reporting live events on the Web.
- A platform for reporting live events, with a focus on displaying data and information in accessible ways.
- Function as a live CMS. Dynamically populate content areas on an event page for the viewers.
- Establish events as core functionality. A public-facing page on Datajam corresponds to an event. Events are created, produced, and ultimately archived.
- Embed events on third-party sites.
- Comprehensively track metrics for events.
Though it can be installed on any rack-compatible stack with the above dependencies met, Datajam targets Heroku for deployment.
To use our one-step installer, follow the Heroku quickstart instructions
and then run
sh <(curl http://get.datajam.org) from your Mac or Linux computer.
For other operating systems, or to install to your own hardware, run the following commands:
$ rvm use 1.9.3 $ gem install bundler $ git clone https://github.com/sunlightlabs/datajam.git $ cd datajam/ $ bundle install --binstubs $ bin/rails start
Bundler takes care of installing all the other Ruby libraries used by Datajam, and the JS libraries are included in the project. But it's still important to know about them:
- Mongoid as an object mapper to MongoDB
- Jammit for static asset packaging
- Rocco for literate programming
Datajam is intended to be reused and extended by third parties. As such, certain development guidelines should be adhered to:
- Unit test coverage for all files in
- Acceptance test coverage for all user stories with Capybara.
- Continuous integration at Travis-CI
A Vagrant box is provided for painless bootstrapping of a dev environment. Install VirtualBox, Vagrant, and run
vagrant up from your datajam directory.
Datajam consists of three pieces:
- Front-end: Public-facing part of the app. Presents a view of the event as defined by the back-end. The home page displays the current event (or a message announcing the current event). Alternate views of the current event are available to third parties via the embed mechanism. Archive pages display past events.
- Back-end: Administrative area that reporters use. Includes the interface for creating and editing events. Powers the front-end by defining templates for the event views.
- Content Plugins: Define a data model and provide UI elements for the back-end and front-end. Both the back-end and front-end are architected to provide hooks for the plugins. Content plugins define specific implementations of content areas for the front-end, and administrative functionality in the back-end.
Datajam ships with two content plugins: Data Card and Live Chat which are implemented as Rails Engines. Custom plugin development is possible via hooks provided by Datajam.
Download plugins and learn about plugin authoring at datajam.org/plugins
Copyright (c) 2011-2012 by the Sunlight Foundation.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.