{"id":23389862,"url":"https://github.com/vaibhav-chitransh/whispr","last_synced_at":"2026-04-07T07:32:55.852Z","repository":{"id":268015365,"uuid":"903003412","full_name":"Vaibhav-Chitransh/Whispr","owner":"Vaibhav-Chitransh","description":"A modern real-time chat application built with the MERN stack, featuring secure authentication, real-time messaging, profile management, user search and filtering, and more. Enhance your communication experience with Whispr Chat!","archived":false,"fork":false,"pushed_at":"2025-01-15T13:38:09.000Z","size":1100,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-03T14:23:50.797Z","etag":null,"topics":["bcryptjs","cloudinary","cookie-parser","cors","dotenv","express","jwt","lucide-react","mongodb-atlas","mongoose","nodejs","react","shadcn-ui","socket-io","tailwindcss","zustand"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vaibhav-Chitransh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-13T18:08:11.000Z","updated_at":"2025-04-23T14:27:22.000Z","dependencies_parsed_at":"2024-12-13T20:26:30.401Z","dependency_job_id":"76eb8c7f-cbb0-42a2-af6e-d4ab2eab0292","html_url":"https://github.com/Vaibhav-Chitransh/Whispr","commit_stats":null,"previous_names":["vaibhav-chitransh/whispr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Vaibhav-Chitransh/Whispr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vaibhav-Chitransh%2FWhispr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vaibhav-Chitransh%2FWhispr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vaibhav-Chitransh%2FWhispr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vaibhav-Chitransh%2FWhispr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vaibhav-Chitransh","download_url":"https://codeload.github.com/Vaibhav-Chitransh/Whispr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vaibhav-Chitransh%2FWhispr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31504896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bcryptjs","cloudinary","cookie-parser","cors","dotenv","express","jwt","lucide-react","mongodb-atlas","mongoose","nodejs","react","shadcn-ui","socket-io","tailwindcss","zustand"],"created_at":"2024-12-22T03:18:47.136Z","updated_at":"2026-04-07T07:32:55.816Z","avatar_url":"https://github.com/Vaibhav-Chitransh.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Whispr Chat App\n\nWhispr Chat is a modern, feature-rich real-time chat application built using the MERN stack. Designed for seamless communication, it currently supports one-to-one chats, with exciting features like group chats, customizable themes, and video calling in development.\n\n**Home Page**\n\n![Home Page](./images/home_image.png)\n\n## Key Features\n\n### 1. **User Authentication**\n- **Secure Sign-Up and Login**: Users can create accounts and log in securely using email and password authentication.\n\n**Signup Page**\n\n![Signup Page](./images/signup_image.png)\n\n- **Login Page**\n\n![Login Page](./images/login_image.png)\n\n### 2. **User Profile Management**\n- **Profile Page**: Each user has a dedicated profile page displaying their username, email, and profile picture, last updated, member since.\n- **Bio Update**: Users can add or edit a personal bio to share more about themselves.\n- **Profile Picture Upload**: Upload and change profile pictures to personalize accounts.\n\n- **Profile Page**\n\n![Profile Page](./images/profile_image.png)\n\n### 3. **Real-Time One-to-One Chat**\n- **Instant Messaging**: Real-time text messaging between users.\n- **Online Status Indicators**: Visual cues to show if a user is online or offline.\n- **Message Timestamps**: Each message displays the time it was sent.\n\n- **Chat Page**\n\n![Chat Page](./images/chat_image.png)\n\n### 4. **User Search and Filtering**\n- **Search by Username**: Quickly find other users by searching for their username.\n- **Online/Offline Filtering**: Filter user lists to display only online or offline users, enhancing the chat experience.\n\n- **Filter Users**\n\n![Name](./images/searchFillter_image.png)\n\n![Online](./images/onlineFilter_image.png)\n\n---\n\n*Note: Features under development, such as group chats, customizable themes, and video calling, are not included in this list.*\n\n## Tech Stack\n\n- **Frontend**: React.js, TailwindCSS, zustand\n- **Backend**: Node.js, Express.js\n- **Database**: MongoDB\n- **Real-Time Communication**: Socket.io\n- **Authentication**: JWT (JSON Web Tokens)\n\n---\n\n## How to Run the Project Locally\n\nFollow the steps below to set up and run the Whispr Chat app on your local system.\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/Vaibhav-Chitransh/whispr-chat.git\ncd whispr-chat\n```\n\n### 2. Install Dependencies\n#### Backend\n1. Navigate to the `server` folder:\n   ```bash\n   cd server\n   ```\n2. Install required packages:\n   ```bash\n   npm install\n   ```\n\n#### Frontend\n1. Navigate to the `client` folder:\n   ```bash\n   cd ../client\n   ```\n2. Install required packages:\n   ```bash\n   npm install\n   ```\n\n### 3. Set Up Environment Variables\n1. Create a `.env` file in the `server` folder and add the following variables:\n   ```env\n   MONGO_URI=\u003cyour-mongodb-connection-string\u003e\n   JWT_SECRET=\u003cyour-jwt-secret\u003e\n   PORT=5000\n   SOCKET_PORT=6001\n   ```\n\n### 4. Start the Application\n#### Backend\n1. Start the backend server:\n   ```bash\n   cd server\n   npm start\n   ```\n\n#### Frontend\n1. Start the frontend server:\n   ```bash\n   cd client\n   bun run dev\n   ```\n\n### 5. Access the Application\n1. Open your browser and navigate to:\n   ```\n   http://localhost:5173\n   ```\n\n---\n\n## Future Roadmap\n\n### Upcoming Features\n- **Group Chat**: Enhanced group communication functionality.\n- **Customizable Themes**: User-selectable themes to improve UX.\n- **Video Calling**: Fully functional video conferencing within chats.\n- **File Sharing**: Share files and media directly in conversations.\n- **Push Notifications**: Stay updated with real-time notifications.\n\n---\n\n## Contribution Guidelines\n\nWe welcome contributions from the community! If you'd like to contribute:\n\n1. Fork the repository.\n2. Create a new branch for your feature/bugfix.\n3. Commit your changes and push the branch.\n4. Submit a pull request with a detailed description of your changes.\n\n---\n\n## Contact\n\nFor any queries or support, feel free to reach out:\n- **Email**: vaibhavchitranshbdn@gmail.com\n- **GitHub**: [Vaibhav-Chitransh](https://github.com/Vaibhav-Chitransh)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaibhav-chitransh%2Fwhispr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaibhav-chitransh%2Fwhispr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaibhav-chitransh%2Fwhispr/lists"}