Rallly is a free collaborative scheduling service
Clone or download
Pull request Compare This branch is 10 commits ahead, 8 commits behind lukevella:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
api/event
bin
config
docs
helpers
public
views
.bowerrc
.dockerignore
.editorconfig
.gitignore
.snyk
.travis.yml
Dockerfile
LICENSE
README.md
app.js
bower.json
communicator.js
config.sample.json
docker-compose.yml
gulpfile.js
install.js
package.json
sample.env
yarn.lock

README.md

c3bc254fbaf76152cc6a9dc5d91714874bfc294b8d8d785db87157ed68aa2b3c45e82ab55f6f0e346aeec0bca00ea85862ba06e247ed4d365b968812fbc43c78

Build Status

Rallly is a free collaborative scheduling service that helps you and your friends vote on a date to host an event. The application has been developed with the MEAN stack of technologies.

Getting Started Quickly with Docker

This assumes that you have Docker installed

To get started quickly and easily, simply run the following:

git clone git@github.com:lukevella/Rallly.git
cd Rallly

Copy the sample .env file then open it and set the variables.

cp sample.env .env

Now run the server!

docker-compose up -d

Now that was simple!

Manual Setup Detailed Production Docs

Requirements

To run Rallly you will need:

  • MongoDB
  • Node.js + npm
  • Bower (Not Necessary)

Setup

Clone the repository on your machine and set the current directory to the root of the repository

git clone git@github.com:lukevella/Rallly.git
cd Rallly

Run the install script. This will install the node and bower dependencies and create a configuration file.

npm run installation

Manual Configuration

Only do this if you did not run npm run installation

Run the config script.

npm run installation -- -p

Open up config.json and fill in the parameters.

{
    "port": 3000,
    "siteUrl": "http://localhost:3000", // Used for creating an absolute URL
    "fromName": "Rallly", // Email from name
    "fromEmail": "no-reploy@rallly.co", // Email from address
    "dbName": "rallly", // MongoDB database name
    "dbAddress": "localhost", // MongoDB address not including port.
    "dbUser": "", // MongoDB user name - leave blank if MongoDB auth is disabled
    "dbPwd": "", // MongoDB user password - leave blank if MongoDB auth is disabled
    "smtpUser": "", // SMTP user name
    "smtpPwd": "", // SMTP user password
    "smtpHost": "", // SMTP host
    "smtpPort": 587 // SMTP port
}

Running

To start the node server simply run npm start.

Development Detailed Docs

If you're going to be developing, run the watch task with gulp. Gulp is used to build the CSS (with SASS), JS and templates.

gulp watch
npm start

License

See the LICENSE file.