# Vue Forum

Simple and beautiful forum software - created using Express, Vue, and Sequelize.    
[Click here](https://vue-forum.herokuapp.com) for a link to the demo.

## Features
* Mobile ready single-page application
* Real-time notification system
* Profile pictures
* Infinite-scroll loading of posts and threads
* @ mentions
* Polls
* Markdown editor
* Inline link expansions for Twitter, GitHub, Wikipedia, and more to come
* Admin dashboard for forum analytics
* Multiple admin users
* Moderation built in, including:
  * Locking or deleteing threads and posts
  * Blocking user IP address
  * Suspending users from creating posts or starting threads

## Screenshots

### Homepage
![forum homepage](https://user-images.githubusercontent.com/5166028/45904046-ae0b4480-bde3-11e8-8cdf-f43ab82f1028.png)

### Admin dashboard
![forum dashboard](https://user-images.githubusercontent.com/5166028/45903589-283ac980-bde2-11e8-8297-ed73056c94d9.png)

### Admin settings page
![forum general](https://user-images.githubusercontent.com/5166028/45903591-28d36000-bde2-11e8-80e7-31de17914f50.png)

### Admin user page
![forum users page](https://user-images.githubusercontent.com/5166028/45903588-283ac980-bde2-11e8-89ae-0e08cf7a94a3.png)

### Admin moderation page
![forum moderation](https://user-images.githubusercontent.com/5166028/45903590-283ac980-bde2-11e8-9998-debd3041d5d3.png)

## Install

To install on Heroku:

 1. `git clone https://github.com/sbkwgh/forum.git && cd forum`
 2. `heroku login`
 3. `heroku git:remote -a <app-name>`
 4. `heroku config:set NODE_ENV=production`
 5. `heroku config:set SESSION_SECRET=<session-secret>`
 6. Add database add-on, get database URL
 7. `heroku config:set DATABASE_URL=<database-url>`
 8. `cd frontend && npm install`
 9. `npm run build`
 10. Remove the line `dist/` from `.gitignore`
 11. `cd .. && git add -A && git commit -m "Update .gitignore"`
 12. `git push heroku master`
 13. Visit the URL of the app and complete the on-screen instructions

N.B. the database here is assumed to be MySQL - to use Postgres or another you must install the corresponding driver on npm