Skip to content
A minimal forum board application. Built on top of React-Redux frontend, ExpressJS-NodeJS backend (with PassportJS for OAuth) and MongoDB databse.
JavaScript CSS HTML
Branch: master
Clone or download
Latest commit 7a7812d Sep 26, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
config updated credential sample Jun 6, 2017
docs updated comments Jun 7, 2017
frontend updated tests Jun 19, 2017
public updated build Jun 5, 2017
.babelrc initial commit Dec 13, 2016
.editorconfig added react-router and cofig server for using browser history Dec 15, 2016
.eslintrc updated project structure Jan 12, 2017
LICENSE Initial commit Dec 13, 2016 Update Sep 26, 2019
package.json updated tests Jun 19, 2017
server.js added git authentication system, updated backend architecture Mar 20, 2017



A minimal forum application built with the following technologies:

Demo app is deployed on Heroku. Please check it out:

Application Features

  • Users can post a discussion
  • Users can reply their opinions regarding discussion
  • Users can favorite discussions
  • Users have their own profile page
  • Admin can create new forum categories
  • Admin have a lot of power over every users discussions and opinions :-p


Home View

home view

Admin View

admin view

Deploy on you own server

Please make sure you have following software installed in your system:

  • Node.js > 6.0
  • NPM / Yarn
  • Git
  • MongoDB

First we need to clone the repository:

$ git clone

Then we have to install the necessary dependencies using either NPM or Yarn:

$ npm i
$ yarn

Since the app currently uses GitHub authentication, we need to configure a GitHub OAuth application. You can register a new application from this link

We need to grab the following information from the OAuth application.

  • Client ID
  • Client Secret
  • Callback URL

The Callback URL is the domain where GitHub will redirect the user after a successful login. You can use a domain name or local host. But we need to append the URL with the path /api/user/authViaGitHub/callback. So, the complete url will look like: https://localhost:8080/api/user/authViaGitHub/callback

Now, we need to configure the credentials inside of the codebase. Open the file config/credentials.js add the necessary information. The file looks like this:

module.exports = {
  DBURL: '',

We need to provide all the information here. You can notice that we need the database url here too. My local MongoDB url looks like:


Now we are ready to run the application. You can run either run the development environment of the application which will include Hot-Reload for JS codes using Webpack and the Redux dev tool extension, or you can run the production edition. The default port for developer edition is 8080, and for production is process.env.PORT.

To run the app in development environment:

$ npm run start:dev

To run the app in production environment:

$ npm run start

Now, if you visit http://localhost:8080 (if you ran the dev), or the production URL, you will see that the application is up and running. Congratulation! But, wait a minute, it's showing you Sorry, couldn't find the forum. That is because, we didn't create any forum yet. You can now sign up via github and then visit the admin panel with the url http://localhost:8080/admin. The application is currently configured in a way that, the first user will become the admin for the system.

Here we can create new forums and that forum will be displayed in the application. The first forum will be used as default forum.

Congratulation! You now have a clone of this application in your server. :-)

Path for Future Work

  • Add search functionality
  • Add unit tests for both backend and frontend
  • Ability to change the name and logo of the site from admin panel.
  • Make the installation process more interactive
  • Add multiple theme support.


MIT License. Do whatever you want to do. :-)


The application is created with lots of ♥. Any pull request, issues and contribution is very appreciated. It would be really great if we can take this application to the next level, where it can be used as a platform for forums.

Provash Shoumma

You can’t perform that action at this time.