Skip to content

Dun-sin/Whisper

Repository files navigation

Whisper

An app to help you chat in secret

View Demo · Report Bug · Request Feature

GitHub Repo stars contributors GitHub Repo forks issues

Whisper

This app is developed to make chatting much private and easy without stealing your data!!

✨ Built With

React
React
Javascript
JavaScript
NodeJS
NodeJS
MongoDB
MongoDB
MongoDB
Docker
SocketIo
SocketIo
TailwindCSS
TailwindCSS

🖼️ Screenshot

image

(back to top)

📚 Getting Started

To get a local copy up and running follow these simple steps.

👇🏽 Prerequisites

Before installation, please make sure you have already installed the following tools:

🛠️ Installation

  1. Fork the project. Click on the fork icon in the top right to get started

  2. Clone the project, you can use the following command:

    git clone https://github.com/<your-github-username>/Whisper
  3. Navigate to the project directory

    cd Whisper
  4. Use .env_sample to configure the .env file for both client and server. For the server .env mongodb url use the localhost to test

    Check this video of how to do that: https://www.youtube.com/watch?v=D0U8vD8m1I0

  5. Run the application with docker compose

    docker-compose up -d
  6. Port mappings:

    • Server running on port 4000
    • Client running on port 5173
    • MongoDB running on port 27018
  7. To test things out, you can open the same URL in two different browsers or open a private browsing window in the same browser. This allows you to connect to yourself, use login anonymously if you aren't dealing with anything that uses user data, else use login and open an account on mailtrap using their demo to domain and get the token into .env

For those who do not wish to use Docker, here is another option -> to start the project

(back to top)

🎨 Demo

Check out the website: Whisper

(back to top)

👩🏽‍💻 Contributing

  • Contributions make the open source community such an amazing place to learn, inspire, and create.
  • Any contributions you make are greatly appreciated.
  • Check out our contribution guidelines for more information.

(back to top)

✏️ Edit with Gitpod

Click this button to run this project in Gitpod which comes with pre-configured environment.

Contribute with Gitpod

(back to top)

👨‍👩‍👦 Community

Don't forget to join the discord community - Join us

🛡️ License

Whisper is licensed under the MIT License - see the LICENSE file for details.

(back to top)

💪🏽 Thanks to all Contributors

Thanks a lot for spending your time helping Whisper grow. Thanks a lot! Keep rocking🍻

Contributors

(back to top)

🙏🏽 Support

This project needs a star️ from you. Don't forget to leave a star🌟

(back to top)