Skip to content

demon-bixia/Tolk

Repository files navigation


A Beautiful Django, Vanilla JavaScript Chat Application


About ℹ️

Tolk is a single page chat web application developed using django web framework and JavaScript.
It uses django channles and JavaScript WebSockets to send messages, notifications, and status updates. it also comes with two themes Dark Purple and White Light.
You can check it out in demo.


Features ⚡

  • sending/receiving messages
  • contacts system
  • create groups
  • privacy mode
  • dark/light modes
  • notifications
  • send attachments
  • API at /api
  • search
  • single page application

Setup 🔧

clone the repo

git clone https://github.com/demon-bixia/Tolk.git

enter the project's folder

cd TolkProject

checkout the development branch

git checkout devleopment

install dependencies

pip install -r requirements.txt

now run the daphne server

docker compose up

visit http://127.0.0.1:8000/ and you will see the tolk preloader.


ScreenShots 📷

dark_theme

login

light_theme


Custom Fronted Framework

The tolk fronted is built using a custom js library in the folder assets/js/app/silly. The library simply splits html code into templates (i call them components in code) and then renders them using the ejs template engine. There is also an interface for sending ajax and websocket messages. it's meant to be used to rapidly convert static html pages into dynamically rendered ones.

silly_class_diagram

A UML Class Diagram For Silly.