Skip to content
🚀 Forum app built in React, Redux & Django
JavaScript Python CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml May 28, 2019
backend chore(deps): Bump pillow from 5.1.0 to 6.2.0 in /backend (#12) Nov 4, 2019
frontend chore: update deps Sep 17, 2019
preview refactor utils & change preview May 7, 2018
.gitignore chore: add prettier Sep 24, 2018
LICENSE.MD
README.md
netlify.toml chore: move to netlify Sep 24, 2018

README.md

Rengorum

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

https://youtu.be/t9vWwxydREs

Forum app in ReactJS and Django

Frontend

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

Demo Screenshots:

Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

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:

API endpoint

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
pip 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

(Optional) Run test

python manage.py test

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

python 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

python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
You can’t perform that action at this time.