a realtime chat application for developers
Ruby JavaScript HTML CSS Other




Build Status Code Climate Coverage Status wercker status


AsakusaSatellite is a realtime chat application for Developers.


  • @suer
  • @mallowlabs
  • @mzp
  • @shimomura1004
  • @banjun


  • Ruby 1.9.3 / 2.0.0 / 2.1 / 2.2 / 2.3 or JRuby 1.7.1
  • RubyGems 1.4.2 or later
  • Bundler 1.0.7 or later
  • MongoDB 1.8.1 or later


Install dependencies:

$ bundle install --path .bundle --without development test

Precompile assets:

$ bundle exec rake assets:precompile RAILS_ENV=production

If you upgrade AS from 0.7.0 or older, execute following:

$ curl https://raw.github.com/gist/2792357/asakusasatellite_migration_for_v0.7.0 | mongo <db_name>

Excecute mongodb and socky:

$ mongod --dbpath <dir_name>
$ bundle exec thin -R socky/config.ru -p3002 -t0 start

Run AsakusaSatellite:

$ bundle exec rails s -e production

and access to http://localhost:3000/

For JRuby user

How to deploy

$ bundle exec rake assets:precompile
$ bundle exec warble


  • Don't use socky on JRuby. use keima or pusher
  • Don't use newrelic

For developers

Install for Developer

$ cp misc/bleis-hooks/* .git/hooks


You need test db to run tests.

$ mongod --dbpath <test_dir_name>

individual testing

$ bundle exec rspec spec/{controller,model}/$(name)_spec.rb

test all

$ bundle exec rake

run with rcov

$ bundle exec rake spec:rcov

auto testing

$ bundle exec guard start

JavaScript testing

Requirement: phantomjs 1.5+

$ bundle exec rake qunit

Generate Plugin Template

generate filter

$ rails g as_filter test

edit filies

  • plugins/as_test_filter/lib/test_filter.rb
  • plugins/as_test_filter/spec/lib/test_filter_spec.rb

edit config/filters.yml

- name: test_filter

generate viewhook

$ rails g as_viewhook test

edit files

  • plugins/as_test/lib/test.rb
  • plugins/as_test/spec/lib/test_spec.rb


Very cute icons

Several icons are from Farm-Fresh Web Icons. These icon sets are licensed under a Creative Commons Attribution 3.0 License.

Cool sound

Cool sound is created by On-Jin. Do not redestribute the sound file.

Redmine logo

Redmine Logo is Copyright (C) 2009 Martin Herr and is licensed under ThereCreative Commons Attribution-Share Alike 2.5 Generic license.

See http://creativecommons.org/licenses/by-sa/2.5/ for more details.