Chatbox: Exchange messages between users.
Written in Python/Django

Note

During development and deployment I encountered CSRF verification errors and documented the issue and fix in a forum post. This may help others facing similar production issues: https://forum.djangoproject.com/t/forbidden-403-csrf-verification-failed-request-aborted-error-encountered-in-production/34354

Features

• Private 1 on 1 conversations with other users
• Send links and images with low latency
• Delete individual messages or entire conversations

Database Schema

Usage

Local Development

First install uv and sync the project dependencies:

cd path/to/root/directory
pip install uv
uv sync
uv sync --extra dev  # for devs only

Migrate database:

uv run manage.py migrate

Run Django server:

uv run manage.py runserver

Access web application at http://127.0.0.1:8000 or http://localhost:8000.

Run Tests

uv run manage.py test

Demo Images

Contributing Guidelines

Pull Requests

• Simplicity: Keep changes focused and easy to review.
• Libraries: Avoid adding non-standard libraries unless discussed via an issue.
• Testing: Ensure code runs error-free, passes all tests, and meets coding standards.

Bug Reports

• Report bugs via GitHub Issues.
• Submit pull requests via GitHub Pull Requests.

Thank you for supporting Chatbox!