Rengorum

Single-page forum application built in ReactJS and Django Rest Framework.

Live Demo: https://forum.endiliey.com/

https://youtu.be/t9vWwxydREs

Frontend

The frontend is a fast, interactive and simple Single-Page-Application (SPA), written in ES6 Javascript and built with following technologies:

React v16

Redux v4

React Router v4

Redux Thunk v2

Redux Persist v5.9

etc

Demo Screenshots:

Backend

The backend is a scalable system that provides data through its RESTful API (browseable API available), written in Python and built with following technologies:

Django v2.0

Djangorestframework v3.7

etc

API endpoint for Demo: https://rengorum.endiliey.com/api

List of available API (browseable) at /api
* /user/
* /user/login/
* /user/register/
* /user/logout/
* /user/{username}/
* /user/{username}/edit
* /user/{username}/delete
* /forum/
* /forum/create/
* /forum/{slug}/
* /forum/{slug}/edit/
* /forum/{slug}/delete/
* /thread/
* /thread/create/
* /thread/{id}/
* /thread/{id}/edit/
* /thread/{id}/delete/
* /post/
* /post/create/
* /post/{id}/
* /post/{id}/edit/
* /post/{id}/delete/

Installation

Make sure you have following software installed in your system:

Python 3
Node.js
NPM / Yarn
Git

First, we need to clone the repository

git clone https://github.com/endiliey/rengorum.git

Install all required dependencies in an isolated environment

cd rengorum/backend
python3 -m venv venv
source venv/bin/activate (windows: venv/Scripts/activate.bat)
pip3 install -r requirements.txt

Copy the .env.example as .env in backend folder

cp .env.example .env

Install all required dependencies for frontend in rengorum/frontend folder by typing

cd ../frontend
yarn

Copy the .env.example as .env in frontend folder

cp .env.example .env

Running Backend on Local Server

Activate virtual environment

cd backend
source venv/bin/activate (windows: venv/Scripts/activate.bat)

(Optional) Run test

python3 manage.py test

Then run the server, api endpoint should be available on http://localhost:8000/api

python3 manage.py runserver

Running Frontend on Local Server

Start development server

cd frontend
yarn start

Frontend should be available on http://localhost:3000/

Test User

By default, the database for development server in backend/db.sqlite3 is already filled with some data for ease of development. The superuser id is irene and password is irene as well.

If you want to start clean. Delete db.sqlite3 and follow this step in backend folder

python3 manage.py makemigrations
python3 manage.py migrate
python3 manage.py createsuperuser

kelvinau / rengorum