Prototype Instructions

InvisionApp Protoype

Open prototype here.

Note that the functional prototype should start immediately after 'Login with Instagram' is clicked in the InvisionApp prototype. One should also move back to the InvisionApp prototype after the survey questions have been answered in the functional prototype. These haven't been linked as the InvisionApp prototype is usually quite slow to open.

In the Instagram menu screen in the InvisionApp prototype, clicking 'Unhealthy Profiles' should direct the user to the recommendations screen in the functional prototype at localhost/recommendations.

Getting Access to the Functional Prototype

There is a hosted version of the prototype which may be started on request. Contact Darren for a link to this.

Installing the Functional Prototype

To install the functional prototype on your local machine, first clone this repository onto your computer. These instructions assume you're on a Mac or Linux machine.

git clone https://github.com/deco3500-2018/social-media.git

Then install Node and NPM using nvm by following the instructions on [this page)(https://github.com/creationix/nvm):

Make sure you have python 2.7 installed.

You can check this by running

python -V

Start up MySQL and create a new database. Import the dummy data from dummy-data/InstagramEmotions.sql into the database.

Configure the server to access the newly created database. To do this, create a file named config.js inside /server/ and fill with the following contents. Make sure to replace the config details with the details pointing to the database you just created.

// config.js
var config = {
    db: {
        host: 'localhost',
        port: 8889,
        database: 'InstagramEmotions',
        username: 'root',
        password: 'root',
    }
};

module.exports = config;

In server/python, create a file called login.config and inside it put the login details to an Instagram account. It is highly recommended that you use the details for a test account.

You will need a python/credentials.json file before starting the server. Please contact Darren for help with this.

Start the server by using npm start inside /server.

Using the Functional Prototype

Once the server has been started, the prototype may be opened by navigating to localhost in a web browser on the same computer. The initial screen presented will be a login screen, where the name of a public Instagram account is expected. A known working example is natgeo.

After login, you will be prompted to answer 4 questions about your well-being on Instagram. The prototype will not respond after clicking a response for the final question. After answering all 4 questions, navigate to localhost/recommendations to see a list of recommendations of which accounts should be unfollowed. These recommendations are generated based on the dummy information in dummy-data/InstagramEmotions.sql and the questions about well-being you just answered.