Skip to content

Latest commit

 

History

History
63 lines (48 loc) · 3.2 KB

README.md

File metadata and controls

63 lines (48 loc) · 3.2 KB
Raw

Introduction

Stackle is a web communication portal aimed at providing Open Source organizations a platform to have discussions on their GitHub projects and their issues. It provides GitHub integration which allows the administrator of an organization to create a forum thread for the particular organization. Users signing in are able to view forums of the organizations they contribute to and engage in the forum discussions.

Implementation Details

MEAN stack is used for developing Stackle.

  • Front-End is developed using AngularJS
  • Back-end is handled by NodeJS using Express
  • MongoDB is used as the databases for storing data related to stackle

Architecture

Users interact with the application through the AngularJS front-end which communicates with Node-API to get and post data to the MongoDB server. The front-end also communicates with GitHub API to get data related to Users, repositories and organizations. Users can login to the application through auth0 login integrated to Stackle.

Setting Up the Project

These are the instructions on how to setup the project locally.

Pre-requisites

  • NodeJS 6.X or higher
  • MongoDB Community edition

Installing MongoDB

On Windows

  1. Download the lastest production release of MongoDB (3.4.6 or higher) from here.
  2. Create the data directory to store all data. Create a the directory on the drive from which you start MongoDB. (Ex: If you are starting the MongoDB from the drive 'C'. You should create the directory as C:\data\db\ ).
  3. To start the MongoDB, fire up a command line and run mongod.exe (ex: "C:\Program Files\MongoDB\Server\3.4\bin\mongod.exe" )
  4. To connect to the MongoDB, use the mongo.exe shell. For that open up a command line an run mongo. (Ex: "C:\Program Files\MongoDB\Server\3.4\bin\mongo.exe" ).

For more information refer the MongoDB manual on installing MongoDB Community edtion.

Stackle API

  1. cd in to the stackle_api directory.
  2. Run npm install to install the packages required.
  3. Once all the packages are installed run npm start

Stackle App

  1. cdin to the stackle_app directory
  2. Run npm install to install the packages required.
  3. Once all the packages are installed, run gulp serve

Running Tests (Protractor)

  1. Run npm install -g protractor to install protractor globally.
  2. To get started with a Selenium Server, run 
    webdriver-manager update
webdriver-manager start
  3. cd in to root directory and run ./ui-tests.sh
  4. To add more tests, edit stackle_tests.js located in stackle_app

Running with Docker

  1. Change the url in the database config file in stackle_api/config/database.js as url : 'mongodb://mongo:27017/stackle'
  2. In the root of the Stackle directory, run docker-compose build
    • If you are on Linux machine, execute the following steps to install compose. 
      sudo curl -L https://github.com/docker/compose/releases/download/1.17.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
  3. Once build completes, run docker-compose up