Welcome to Collabbit
Collabbit is a web-based communication tool which helps coordinate and organize relief efforts in times of disaster and recovery. It aims to eliminate burdensome conference calls between the various parties involved, replacing them with quick and easy updates online, as well as provide a written record of the progress of the event.
Doing Collabbit Development
Before you start...
- Install Ruby on Rails and MySQL.
- Create a GitHub account and upload a public key so you have SSH access.
- Fork the latest stable version on GitHub. It's always available on GitHub.
git clone email@example.com:YOURUSERNAME/collabbit.gitto get a copy of your fork.
config/database.ymlfile. A simple default is available here.
You'll need to add the username/password of a MySQL user with all permissions on tables starting with
- Create a folder
smtp.yml, and—if you're going to be deploying with Capistrano—a
Default versions of these files may be found in this gist. The default settings are only suitable for development and should not be used on production systems.
rake gems:installto install all of the necessary gems.
rake db:redoto create, migrate, and seed the database.
Add the following line to your HOSTS file (
/etc/hostson Linux; this will require root permissions):
127.0.0.1 collabbit.dev demo.collabbit.dev
(Alternatively, if you can't modify your HOSTS file for whatever reason, you can also use an external domain that redirects to localhost. One such domain is localhacks.com, which redirects *.localhacks.com to localhost.)
script/serverand go to
http://demo.collabbit.dev:3000. Collabbit should be running, and you can log in with one of the default users' usernames/passwords. (Those can be found in
Code Style Guidelines
For editing Ruby files (.rb), please have your editor configured to use spaces instead of tabs, and have the tab width set to two spaces. For editing CSS and Erb templates, please have your editor configured to use tabs, not spaces. We are planning to migrate all templates to Haml and all CSS to Sass over the summer. Once that's complete, we'll standardize on two spaces for all filetypes.
In addition, please always indent nested block HTML tags, and nest CSS hierarchically. For a style example, see this gist.
Do not add author or license declarations to the top of files you're committing. All files committed to Collabbit must be licensed by the author under the LGPL. The license is specified here, in the readme, and a copy is available in the top-level files
LICENSE_LGPL.txt. Commit records provide a record of authorship.
This program is licensed under the GNU Lesser General Public License version 3, an additional set of permissions on top of the GNU General Public License version 3.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License and the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses.