Skip to content

mcnuttandrew/forum-explorer

Repository files navigation

Fex: Forum Explorer

Fex: Forum Explorer is a web application that provides a principled rethinking of the way in which we interact with async threaded conversations on the internet through the use of visualization. We focus on HackerNews because of its active community and advantageous api.

You can use this app as website (which you can install on tablets as a PWA)

Or

You can install the app as a chrome extension

You can take a look at the theoretical justification for this work in this extended abstract or take a look at the poster that goes along with it.

demo image

Interesting Conversations

Maybe you are at a loss of which pages to look at? Here are a few interesting ones:

Contributions

Thoughts and PRs are always welcome. Make sure any changes you want to add run correctly in the the development environment, see above.

Dev Notes

Local Usage

To run the application in development mode download and cd into the repo. Make sure you have node version >= 9 installed.

npm install

npm run start

Point your browser to 8080. This will bring up the debugging page. Various environmental configurations can be altered in src/constants/environment-config.json, such as website mode (for demoing the functionality deployed on the PWA).

We make use of a caching micro-service hosted on Heroku to serve amortize the cost of building and serving our LDA topic models. If you are NOT okay with using this cloud resource, then you can run the service locally. To do so open a second terminal and run

npm run serve

Creating builds

To create a chrome extension build, make sure DEV_MODE=false (see constants/index) and then run

./prepare-build.sh

You can then install this in chrome as above. Nb: this uses yarn for deterministic installs, so you should have that installed in order to create builds appropriately.

To create a web page build, make sure DEV_MODE=false and WEB_PAGE_MODE=true and the run

./prepare-site.sh

This will attempt to push up to a gh-pages hosting for whatever repository the remote is connected to.

Releases

No releases published

Packages

No packages published

Languages