{"id":21765719,"url":"https://github.com/mutasim77/tele-consult","last_synced_at":"2026-04-09T09:48:31.116Z","repository":{"id":247094391,"uuid":"824324211","full_name":"mutasim77/tele-consult","owner":"mutasim77","description":"📱💬 Real-time online consultation service for mobile phone operators using WebSockets and OTP-based authentication.","archived":false,"fork":false,"pushed_at":"2024-07-17T10:16:37.000Z","size":1127,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T03:44:50.963Z","etag":null,"topics":["nextjs","otp","real-time","socket-io","telecom","ts","websockets"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mutasim77.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-07-04T21:45:27.000Z","updated_at":"2024-11-08T13:28:46.000Z","dependencies_parsed_at":"2024-07-17T12:57:20.037Z","dependency_job_id":null,"html_url":"https://github.com/mutasim77/tele-consult","commit_stats":null,"previous_names":["mutasim77/tele-consult"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutasim77%2Ftele-consult","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutasim77%2Ftele-consult/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutasim77%2Ftele-consult/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mutasim77%2Ftele-consult/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mutasim77","download_url":"https://codeload.github.com/mutasim77/tele-consult/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244741033,"owners_count":20502185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["nextjs","otp","real-time","socket-io","telecom","ts","websockets"],"created_at":"2024-11-26T13:13:38.009Z","updated_at":"2025-12-31T00:03:38.078Z","avatar_url":"https://github.com/mutasim77.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Banner](https://github.com/mutasim77/tele-consult/assets/96326525/6b002524-7ea9-4e8e-a95d-89e176e07b5f)\n\u003cp align=\"center\"\u003e\n  💬 Real-time online consultation service for mobile phone operators using WebSockets and OTP-based authentication. 📡\n\u003c/p\u003e\n\n## 🚀 Introduction\nEver felt stuck with a mobile phone issue and wished for instant expert help? TeleConsult is here to revolutionize customer support in the telecom industry! 📱💬\nThis cutting-edge web app connects you directly with telecom operators in real-time, solving your mobile service headaches in minutes, not hours. No more endless phone queues or frustrating chatbots – just quick, personalized support when you need it most.\nTeleConsult tackles common telecom nightmares:\n- Confusing billing issues? **Solved! 💸**\n- Network problems giving you a headache? **Fixed! 📶**\n- Need help with your new plan? **We've got you covered! 📊**\n\n## 🦄 Features\n- 🔐 Secure OTP-based authentication\n- 💬 Real-time chat with operators\n- 📱 Fully responsive design\n- 🔄 Smart queuing system for operator availability\n- 👥 Dedicated operator interface for efficient support\n- 🌓 Dark mode support\n- 📁 Image sharing in chats\n- 🔔 Real-time online/offline status updates\n- 🌐 Offline mode detection and alert\n\n## 🛠️ Tech Stack\n- **🧠 TypeScript** - For type-safe code\n- **⚛️ Next.js** - React framework for building the UI\n- **💅 Tailwind CSS** - Utility-first CSS framework\n- **🔌 Supabase** - Backend as a Service for real-time features, data storage, and authentication\n\n## 🏃‍♂️ Getting Started\n#### Prerequisites\n- Node.js (v18+ recommended)\n- npm | yarn | pnpm\n\n#### Installation\n1. Clone the repo:\n    ```bash\n    git clone https://github.com/mutasim/tele-consult.git\n    ```\n2. Install dependencies:\n    ```\n   cd tele-consult\n   pnpm install\n   ```\n3. Set up environment variables (check `.env.example`)\n    ```\n    NEXT_PUBLIC_SUPABASE_URL=\n    NEXT_PUBLIC_SUPABASE_ANON_KEY=\n   ```\n5. Run the development server:\n   ```\n   pnpm dev\n   ```\n6. Open `http://localhost:3000` in your browser 🎉\n\n\u003e [!IMPORTANT]\n\u003e While Next.js is lightning-fast in _production_, you might notice slower performance in _development_ mode. For a more accurate representation of the app's speed and to test WebSocket functionality, I strongly recommend running the production build:\n\u003e 1. Build the project:\n\u003e   ```\n\u003e   pnpm build\n\u003e   ```\n\u003e 2. Start the production server:\n\u003e   ```\n\u003e   pnpm start\n\u003e   ```\n\u003e This method will give you a much snappier experience, closer to what end-users will see. It's especially useful for testing _real-time_ features and overall performance. ⚡\n\n## 🌐 Deployment\nTeleConsult is deployed on Vercel. Check it out here: [TeleConsult Live](https://tele-consult.vercel.app/)\n\n\u003e [!IMPORTANT]\n\u003e The deployment is currently working well, but ~there's an ongoing issue with WebSocket (ws) support due to compatibility between my Next.js version and Vercel's infrastructure~. I'll fix it ASAP.\n\u003e ✅ FIXED!\n\n## 📸 Preview\n###  /\n\u003cimg width=\"1000\" alt=\"home page\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/060a9272-fe52-49a9-a407-f879ce60deb2\"\u003e\n\n### 2. /login\n\u003cimg width=\"1000\" alt=\"login page\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/15b3b6d5-ea9d-4e11-b6ef-7ded4a652702\"\u003e\n\n### 3. /help\n\u003cimg width=\"1000\" alt=\"help\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/6f74d563-dbcb-4a89-962d-4f618ac3e2e0\"\u003e\n\n### 4. /chat\n\u003cimg width=\"1000\" alt=\"chat1\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/37bfe1c4-cd21-46bf-a6bc-af2a359c5193\"\u003e\n\n### 4. /chat\n\u003cimg width=\"1000\" alt=\"chat2\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/01dc2245-7ed1-45b5-b201-ffaf3935f74a\"\u003e\n\n### 5. /operator\n\u003cimg width=\"1000\" alt=\"operator\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/4ce7ded6-e411-418f-8636-6c648beb8d59\"\u003e\n\n### 6. /chat \u0026\u0026 /operator\n\u003cimg width=\"1000\" alt=\"chatting\" src=\"https://github.com/mutasim77/tele-consult/assets/96326525/29bfeb48-62cc-40e5-8a64-a72809f00576\"\u003e\n\n## 🔮 Future Plans (TODO)\n- 🛡️ Protect routes using middleware\n- 📧 Add additional authentication methods\n- ⏱️ Implement correct OTP timer\n- 🌍 Add Language Translation using AI\n- 🧠 Enhance AI model for answering basic questions\n- 🎨 Add custom 404 and 500 pages\n- 🔔 Add push notifications\n\n## 🤝 Contributing\nContributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.\n\n- Fork the Project\n- Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n- Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n- Push to the Branch (`git push origin feature/AmazingFeature`)\n- Open a Pull Request\n\n## 📜 License\nDistributed under the MIT License. See [LICENSE](./LICENSE) for more information.\n\nBuilt with ❤️ by [mutasim](https://www.mutasim.top/blog)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmutasim77%2Ftele-consult","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmutasim77%2Ftele-consult","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmutasim77%2Ftele-consult/lists"}