Skip to content

MehdiDinari/Chat-App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗨️ Django Chat Application

Django Python HTMX

A real-time chat application built with Django, HTMX, and WebSockets, supporting public and private chatrooms with file sharing capabilities. 📩


🌟 Features

User Authentication (Login, Registration, Email Verification) ✅ Real-Time Messaging with WebSockets ✅ Public & Private ChatroomsFile Upload Support (Images, Documents) ✅ HTMX for Smooth UXAdmin Dashboard for Chatroom ManagementSecure with CSRF & Authentication Middleware


📌 Installation Guide

1️⃣ Clone the Repository

$ git clone https://github.com/mehdidinari/chat-app.git
$ cd chat-app

2️⃣ Create a Virtual Environment

$ python -m venv venv
$ source venv/bin/activate  # On Windows: venv\Scripts\activate

3️⃣ Install Dependencies

$ pip install -r requirements.txt

4️⃣ Apply Migrations

$ python manage.py makemigrations
$ python manage.py migrate

5️⃣ Create a Superuser (For Admin Panel)

$ python manage.py createsuperuser

6️⃣ Run the Development Server

$ python manage.py runserver

🔗 Visit: http://127.0.0.1:8000/


🖥️ Tech Stack

  • Django 5.1.6 (Backend)
  • HTMX (Lightweight frontend interactivity)
  • Channels (WebSockets for real-time communication)
  • SQLite / PostgreSQL (Database support)
  • Bootstrap / Tailwind CSS (Styling)

🚀 How to Use

💬 Chatrooms

  1. Login/Register to access the chatrooms.
  2. Create a new public or private chatroom.
  3. Start real-time conversations.

📂 File Uploads

  • Upload images and documents directly in the chat.
  • Shared files appear within the chat conversation.

🔧 Admin Panel

  • Manage chatrooms & users: http://127.0.0.1:8000/admin/

🛠️ Contributing

Want to contribute? Follow these steps:

  1. Fork the repository 🚀
  2. Create a new branch: git checkout -b feature-branch
  3. Make your changes & commit: git commit -m 'Added a new feature'
  4. Push to your fork: git push origin feature-branch
  5. Open a Pull Request 🎉

📜 License

This project is licensed under the MIT License. Feel free to modify and use it.


🌎 Connect with Me

🔹 GitHub: @yourusername
🔹 LinkedIn: Your LinkedIn

About

A django + HTMX app for chatting.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors