Cantas

Cantas is a real-time collaborative Web application built upon Node.js and Socket.IO.

Thanks for all Contributors

Getting started

Demo Site - Deployed on OpenShift

http://cantas-onepiecejs.rhcloud.com/

Login with your Google account.

Deploy to OpenShift.

rhc domain create <yournamespace>
rhc app create cantas nodejs-0.10 -s
cd cantas/
rhc cartridge add mongodb-2.4 -a cantas
rhc cartridge add "http://cartreflect-claytondev.rhcloud.com/reflect?github=smarterclayton/openshift-redis-cart" -a cantas
git remote add upstream -m master git@github.com:onepiecejs/nodejs-cantas.git
git pull -s recursive -X theirs upstream master
git push
rhc env set NODE_ENV=production -a cantas
# Caution: please input your variabes in .openshift/lib/init_settings
rhc app restart -a cantas

Note: Openshift instructions need updating Please update your settings value in .openshift/lib/init_settings before push to Openshift Online service.

Setup development environment with one-click.

Installing Vagrant with your package manager,

sudo yum install vagrant

Then run the up command in the root of the project's directory,

vagrant up

Note: If you are on Fedora 22, you will need to install the "libvirt" lib's to run Vagrant from the "vagrantfile" supplied in the root of the Cantas app directory. dnf install libvirt vagrant-libvirt

Setup development environment manually.

• install Nodejs, npm, MongoDB, Redis.

  # nodejs & npm
  wget http://nodejs.org/dist/v0.10.22/node-v0.10.22.tar.gz
  tar -xvf node-v0.10.22.tar.gz
  cd node-v0.10.22
  ./configure && make
  sudo make install
  
  # mongo
  sudo yum install mongodb mongodb-server
  # redis
  sudo yum install redis
  
  #Fedora 22
  dnf install nodejs
  
  #Ubuntu 14+ (Only tested against 14)
  sudo apt-get install nodejs build-essential
  
  #Red Hat 6+ and Centos 6+
  yum install epel-release
  yum install nodejs
  
  #Run Cantas on a MAC
  [MAC OSX Dev Install](https://github.com/onepiecejs/nodejs-cantas/wiki/Setup-development-environment-in-Mac-OS-X)
  
  #NPM
  NPM should be installed as part of the nodejs packages for Fedora, Red Hat, Centos and Ubuntu.

Note: If you got g++: command not found while installing nodejs, you can install it by sudo yum install gcc-c++.

• Kerberos requirements:

Note: If you plan to use Kerberos authentication install the relevant kerberos libraries for your distro.

sudo yum install -y krb5-devel krb5-libs krb5-workstation

• checkout cantas source code and update node packages via npm

  git clone git@github.com:onepiecejs/nodejs-cantas.git
  cd nodejs-cantas
  npm install

• start redis server and mongodb server

  # if you have installed them as services, do
  sudo systemctl start redis
  sudo systemctl start mongod
  # or
  sudo service redis start
  sudo service mongod start

  # otherwise,
  redis-server &
  && mongod --dbpath=/tmp &

• start the app

  # update 'settings.json' file
  cp settings.json.example settings.json
  
  # setup initalize data
  node scripts/migrations/initLabelMetadata.js
  
  # start the app
  NODE_ENV=development node app.js

• for development convenience the following steps will make logging in easy while you are developing

  Edit settings.json and change auth.default to local, then add a user. If local doesn't work try dummy as the auth.default strategy and then add a user.

  node scripts/addUser.js cantas cantas
  

Note: Make sure the mongod deamon is running before starting the app. To enable Google signin you will need to create a Client ID in the Google Developer Console.

That's it. Open your browser at http://localhost:3000 and log into Cantas.

Resources

• HTML5 pushState

Integration && Test Environment

• Grunt task to run jasmine unit tests through phantomjs

Dependencies

• Node.js
• npm
• Backbone.js
• Socket.IO
• Redis
• Mongo

Template engine

• Jade