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.
MEAN stack is used for developing Stackle.
- Front-End is developed using Angular
- Back-end is handled by NodeJS using Express
- MongoDB is used as the databases for storing data related to stackle
Users interact with the application through the Angular 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.
These are the instructions on how to setup the project locally.
- NodeJS 6.X or higher
- MongoDB Community edition
- Download the lastest production release of MongoDB (3.4.6 or higher) from here.
- 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\ ).
- To start the MongoDB, fire up a command line and run mongod.exe (ex: "C:\Program Files\MongoDB\Server\3.4\bin\mongod.exe" )
- 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.
- Download the binary files for the desired release of MongoDB. Download the binaries from the MongoDB Download Center.
- Extract the files from the downloaded archive.
For example, from a system shell, you can extract through the tar command:
tar -zxvf mongodb-osx-ssl-x86_64-3.6.3.tgz
- Copy the extracted archive to the target directory.
Copy the extracted folder to the location from which MongoDB will run.
mkdir -p mongodb
cp -R -n mongodb-osx-ssl-x86_64-3.6.3/ mongodb
- Ensure the location of the binaries is in the PATH variable.
The MongoDB binaries are in the bin/ directory of the archive. To ensure that the binaries are in your PATH, you can modify your PATH.
For example, you can add the following line to your shell’s rc file (e.g. ~/.bashrc):
export PATH=<mongodb-install-directory>/bin:$PATH
Replace with the path to the extracted MongoDB archive.
cd
in to the stackle_api directory.- Run
npm install
to install the packages required. - Once all the packages are installed run
npm start
Make sure you have the angular-cli installed.
cd
in to the stackle-app directory- Run
npm install
to install the packages required. - Once all the packages are installed, run
npm start
orng serve -o
- Run
npm install -g protractor
to install protractor globally. - To get started with a Selenium Server, run
webdriver-manager update webdriver-manager start
cd
in to root directory and run./ui-tests.sh
- To add more tests, edit stackle_tests.js located in stackle_app
- Change the url in the database config file in stackle_api/config/database.js as
url : 'mongodb://mongo:27017/stackle'
- 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
- If you are on Linux machine, execute the following steps to install compose.
- Once build completes, run
docker-compose up