nilportugues / flowchat

A live updating, threaded discussion platform with range voting.

FlowChat — An open-source, live updating, threaded chat platform with range voting.

FlowChat is an open-source, self-hostable, live-updating discussion platform, featuring communities, discussions with threaded conversations, and voting.

It can act as an alternative to forums, as a private team communication platform(like slack), a content creation platform(like reddit), or a voting/polling platform like SimpleVote.

Flowchat tries to solve the problem of having a fluid, free-feeling group chat, while allowing for side conversations so that every comment isn't at the top level. Multiple conversations can take place at once, without interrupting the flow of the chatroom.

It uses range voting(also known as olympic score voting) for sorting comments, discussions, and communities. Range voting is more expressive than simple 👍 or 👎 votes.

Check out the default community, vanilla, or create your own.

It features:

• A complete discussion platform with communities, and live-updating threaded discussions.
• Private or public discussions and communities
• Customizable sorting, by recentness, and popularity.
• Hashtags for discussions and communities.
• Discussion/Community creators can block users, appoint moderators, or delete comments.

Tech used:

• Java Spark, Bootstrap v4, Angular2, Angular-cli, ng2-bootstrap, ActiveJDBC, Liquibase, Postgres, Markdown-it, angular2-toaster

Check out a sample discussion here.

Join the subreddit: /r/flowchat

Change log

---

Installation

If you want to self-host or develop flowchat.

Docker

Requirements

• Docker
• docker-compose

Start the docker instance

git clone https://github.com/dessalines/flowchat
cd flowchat
docker-compose up

Goto to http://localhost:4567

Local development

Requirements

• Java 8 + Maven
• Node + npm/yarn, nvm is the preferred installation method.
• angular-cli: npm i -g angular-cli@latest
• Postgres 9.3 or higher

Download Flowchat

git clone https://github.com/dessalines/flowchat

Setup a postgres database

Here are some instructions to get your postgres DB up and running.

psql -c "create user flowchat with password 'asdf' superuser"
psql -c 'create database flowchat with owner flowchat;'

Edit your pom.xml file to point to your database

cd flowchat
vim service/flowchat.properties

Edit it to point to your own database:

<!--The Database location and login, here's a sample-->
jdbc.url=jdbc\:postgresql\://127.0.0.1/flowchat
jdbc.username=flowchat
jdbc.password=asdf
sorting_created_weight=3600
sorting_number_of_votes_weight=0.001
sorting_avg_rank_weight=0.01
reddit_client_id=
reddit_client_secret=
reddit_username=
reddit_password=

Install flowchat

for local testing:

./install_dev.sh and goto http://localhost:4567/

for front end angular development, do:

cd ui
ng serve

and goto http://localhost:4200

for a production environment, edit ui/config/environment.prod.ts to point to your hostname, then run:

./install_prod.sh

You can redirect ports in linux to route from port 80 to this port:

sudo iptables -t nat -I PREROUTING -p tcp --dport 80 -j REDIRECT --to-ports 4567

---

Bugs and feature requests

Have a bug or a feature request? If your issue isn't already listed, then open a new issue here.