Skip to content

yashksaini-coder/WhisperZone

 
 

Repository files navigation

WhisperZone

A real-time chat application using Flask, Redis, MongoDB, Flask-SocketIO, and a React frontend powered by Vite. This application supports room-based chats with Redis for in-memory message storage and MongoDB for persistent chat history. This project began as a demo for practicing DevOps and has now been made public for Hacktoberfest. Contributions and feature suggestions are welcome!


🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Close PRs 🛠️ Languages
Stars Forks Issues Open Pull Requests Close Pull Requests GitHub language count

(Hacktoberfest) I'm open to new feature ideas! If you have any cool features you'd like to implement, open an issue, and I'll assign it to you so you can start working on it.

Features

  • Real-time communication using WebSockets via Flask-SocketIO.
  • Room-based chat system with dynamically generated room codes.
  • In-memory chat storage using Redis and persistent chat history saved in MongoDB.
  • REST API endpoints to create and join chat rooms, and save chat history.
  • React frontend for user-friendly chat experience.
  • Dockerized setup with Redis, MongoDB, Flask backend, and React frontend running in containers.
  • Integration tests for Redis, MongoDB connectivity, and API functionality.

Prerequisites

Ensure you have the following installed:

Getting Started

Clone the Repository

git clone https://github.com/navaneethkrishna30/WhisperZone.git
cd WhisperZone

Setup Docker Secrets

Create a .env file in the project root and define the following secrets:

REDIS_PASSWORD=your_redis_password
MONGO_INITDB_ROOT_USERNAME=your_mongo_username
MONGO_INITDB_ROOT_PASSWORD=your_mongo_password

Running the Application with Docker

Backend Services

This project uses Docker Compose to manage services (backend, Redis, MongoDB).

  1. Build and start the services:

    docker-compose up --build

    This will start the backend, Redis, and MongoDB in their respective containers. The backend will be exposed on port 5000.

  2. Access the application:

    • The backend API will be available at http://localhost:5000.

Frontend Development

The frontend is built using Vite and React, located in the frontend/ directory.

To run the frontend locally (without Docker), follow these steps:

  1. Navigate to the frontend/ directory:

    cd frontend
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev

    The frontend will now be available at http://localhost:5173.


Running Tests

The application includes integration tests for Redis, MongoDB, and API routes. To run the tests:

  1. Ensure Docker secrets are set for testing (e.g., REDIS_PASSWORD, MONGO_USER, MONGO_PASSWORD).

  2. Run the tests:

    docker-compose -f compose-test.yaml up --build --abort-on-container-exit

    This will start the backend in test mode and automatically run the tests.


Docker Services

The application is divided into the following services:

  1. Backend:

    • Flask app with WebSocket support via Flask-SocketIO.
    • Manages chat rooms and messages.
    • REST API for creating/joining rooms and saving chat history.
  2. Redis:

    • Used for real-time, in-memory message storage and room management.
  3. MongoDB:

    • Used for saving persistent chat history.

Contributing

We welcome contributions from the community. To get started:

  1. Fork the repository. You can do this by clicking the Fork button on the top right of the repository page.

  2. Create a feature branch:

    git checkout -b feature/my-feature
  3. Make your changes.

  4. Run tests locally to ensure everything works as expected.

  5. Commit your changes with a descriptive message:

    git commit -m "Add feature: description of your feature"
  6. Push the changes to your fork:

    git push origin feature/my-feature
  7. Submit a pull request:

    • Go to the original repository on GitHub.
    • Click on the "Pull Requests" tab.
    • Click the "New Pull Request" button.
    • Select your feature branch and submit the pull request.
  8. Wait for review and feedback.

    • Address any comments or requested changes.
    • Once approved, your feature will be merged into the main branch.

Local Backend Development

For local backend development without Docker, follow these steps:

  1. Create a virtual environment and activate it:

    python -m venv venv
    source venv/bin/activate  # For Windows: venv\Scripts\activate
  2. Install dependencies:

    pip install -r requirements.txt
  3. Set environment variables for Redis and MongoDB:

    export REDIS_PASSWORD=your_redis_password
    export MONGO_INITDB_ROOT_USERNAME=your_mongo_username
    export MONGO_INITDB_ROOT_PASSWORD=your_mongo_password
  4. Start the Flask app:

    flask run

The backend will now run locally at http://localhost:5000.

Contributors

Thanks to the following people who have contributed to this project:

navaneethkrishna30
Navaneeth Krishna
yashksaini-coder
Yash Kumar Saini

Reporting Issues

If you encounter any bugs or have suggestions for improvements, please open an issue on GitHub.

Releases

No releases published

Packages

No packages published

Languages

  • Python 33.8%
  • JavaScript 29.8%
  • CSS 14.5%
  • YAML 12.3%
  • HTML 6.8%
  • Dockerfile 2.8%