Community is a hybrid forum and mailing list server.
- Ruby 2.2.1
- Postgres 9.3.5
Installing dependencies on OS X using rvm, Homebrew, and Postgres.app
We recommend Postgres.app if you're on OS X.
Ruby stuff using rvm:
$ rvm get stable $ rvm install ruby-2.2.1 $ rvm use ruby-2.2.1 $ gem install bundler $ gem install foreman
Leiningen and redis using Homebrew:
$ brew update $ brew install leiningen redis elasticsearch # follow the printed instructions to have redis and elasticsearch start automatically on boot
We use foreman which sets environment variables from a
.env file. We don't
check this into version control because it contains secret information. Here is
.env file to get you started:
To generate a Recurse Center client id and secret, go to your Recurse Center settings page and make a new OAuth app. The redirect url should be
http://localhost:5001/login/complete (or your development host name if you don't develop off of localhost).
Running the code
The first time you run the code, install necessary gems and set up your database.
$ bundle $ bin/rake db:setup
After that, start your development server and start building the client JS.
$ foreman start # In another terminal: $ cd client $ lein cljsbuild auto
Running the production ClojureScript
The production client code will sometimes function differently than the development code. This can happen when you forget to add externs for a library you are calling, or if
lein cljsbuild auto randomly makes a bad client. Because of this, we should test the production client before deploying. To do that, you can set
CLIENT_ENV to production and run Foreman. If you don't set CLIENT_ENV, it defaults to the Rails environment.
$ CLIENT_ENV=production foreman start
db/structure.sql instead. We use this because it supports Postgres views.
We use a small ClojureScript wrapper over Jasmine for testing our client. If you're running
lein cljsbuild auto (as above), the client tests will be built automatically.
To run the client tests:
$ bin/rake jasmine # Navigate to localhost:8888 to run the tests. # Refresh the page to re-run the tests.
Copyright © 2015 the Recurse Center
This software is licensed under the terms of the AGPL, Version 3. The complete license can be found at http://www.gnu.org/licenses/agpl-3.0.html.