Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
 
 
db
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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...

  1. Install Ruby on Rails and MySQL.
  2. Create a GitHub account and upload a public key so you have SSH access.
  3. Fork the latest stable version on GitHub. It's always available on GitHub.

Installation

  1. Run git clone git@github.com:YOURUSERNAME/collabbit.git to get a copy of your fork.

  2. Create a config/database.yml file. 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 collabbit_

  3. Create a folder config/settings

  4. Inside config/settings add a keys.yml, an smtp.yml, and—if you're going to be deploying with Capistrano—a deploy.yml.

    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.

  5. Run rake gems:install to install all of the necessary gems.

  6. Run rake db:redo to create, migrate, and seed the database.

  7. Add the following line to your HOSTS file (/etc/hosts on 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.)

  8. Run script/server and 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 db/seeds.rb.)

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_GPL.txt and LICENSE_LGPL.txt. Commit records provide a record of authorship.

License

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.

About

Collabbit is a web-based communication tool which helps coordinate and organize relief efforts in times of disaster and recovery.

Resources

License

GPL-3.0, LGPL-3.0 licenses found

Licenses found

GPL-3.0
LICENSE_GPL.txt
LGPL-3.0
LICENSE_LGPL.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published