{"id":24382961,"url":"https://github.com/kgupta2601/hackthisfall_interestfusion","last_synced_at":"2025-04-11T01:12:12.111Z","repository":{"id":257898052,"uuid":"871194217","full_name":"KGupta2601/HackThisFall_InterestFusion","owner":"KGupta2601","description":"Interest Fusion is an innovative platform tackling mental health challenges in educational institutions by creating meaningful connections through shared interests. We're revolutionizing how students connect, making social interactions more natural and anxiety-free.","archived":false,"fork":false,"pushed_at":"2025-03-03T03:45:27.000Z","size":6301,"stargazers_count":6,"open_issues_count":7,"forks_count":22,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T01:12:03.446Z","etag":null,"topics":["docker","expressjs","iwoc","iwoc2025","mongodb","nodejs","reactjs","redisdb","swoc","swoc2025"],"latest_commit_sha":null,"homepage":"https://hack-this-fall-interest-fusion.vercel.app/","language":"JavaScript","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/KGupta2601.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-11T13:06:43.000Z","updated_at":"2025-03-03T03:45:31.000Z","dependencies_parsed_at":"2025-01-10T19:20:26.160Z","dependency_job_id":"d8dc3a72-ec21-487d-8c7b-c8b2262c1885","html_url":"https://github.com/KGupta2601/HackThisFall_InterestFusion","commit_stats":null,"previous_names":["kgupta2601/hackthisfall_interestfusion"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KGupta2601%2FHackThisFall_InterestFusion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KGupta2601%2FHackThisFall_InterestFusion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KGupta2601%2FHackThisFall_InterestFusion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KGupta2601%2FHackThisFall_InterestFusion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KGupta2601","download_url":"https://codeload.github.com/KGupta2601/HackThisFall_InterestFusion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322571,"owners_count":21084337,"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":["docker","expressjs","iwoc","iwoc2025","mongodb","nodejs","reactjs","redisdb","swoc","swoc2025"],"created_at":"2025-01-19T10:11:12.676Z","updated_at":"2025-04-11T01:12:12.104Z","avatar_url":"https://github.com/KGupta2601.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e  \n  \n## 👨‍💻👩‍💻Interest Fusion\n  \n  [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n  [![Issues](https://img.shields.io/github/issues/KGupta2601/HackThisFall_InterestFusion)](https://github.com/KGupta2601/HackThisFall_InterestFusion/issues)\n  [![Pull Requests](https://img.shields.io/github/issues-pr/KGupta2601/HackThisFall_InterestFusion)](https://github.com/KGupta2601/HackThisFall_InterestFusion/pulls)\n  [![Last Commit](https://img.shields.io/github/last-commit/KGupta2601/HackThisFall_InterestFusion)](https://github.com/KGupta2601/HackThisFall_InterestFusion/commits/main)\n\n  🤝 Connecting minds, fostering relationships, and building communities through shared interests\n\u003c/div\u003e\n\n---\n\n## 🌟 Overview\n\nInterest Fusion is an innovative platform tackling mental health challenges in educational institutions by creating meaningful connections through shared interests. We're revolutionizing how students connect, making social interactions more natural and anxiety-free.\n\n\u003cdetails\u003e\n\u003csummary\u003e💡 Why Interest Fusion?\u003c/summary\u003e\n\n- 🎯 **Targeted Connections**: Match with peers sharing your genuine interests\n- 🔒 **Privacy First**: Your data is shared only with mutual consent\n- 🎮 **User-Friendly**: Simple, intuitive interface without overwhelming questionnaires\n- 🛡️ **Secure**: Robust verification and safety measures\n- 🤖 **Smart Matching**: Advanced algorithms using tree data structures\n\u003c/details\u003e\n\n## 🚀 Features\n\n### Current Capabilities\n- ✨ **Smart Profile Creation**\n  - Customizable interest tags\n  - Authenticated profiles using favorite technique\n  - Minimal yet meaningful data collection\n  \n- 🤝 **Intelligent Matching**\n  - Interest-based connection suggestions\n  - Privacy-preserved profile viewing\n  - Mutual consent-based information sharing\n\n- 🔐 **Security Measures**\n  - OTP verification (Vonage API integration)\n  - SSN-based user authentication\n  - Encrypted data storage\n\n### 🔮 Future Roadmap\n- 📈 **Scalability**\n  - Enhanced database architecture\n  - Load balancing implementation\n  - Performance optimization\n\n- 🛡️ **Enhanced Safety**\n  - AI-powered content moderation\n  - Advanced user verification\n  - Real-time suspicious activity detection\n\n- 💬 **Communication**\n  - Secure in-app messaging\n  - Interest-based group chats\n  - Content filtering system\n\n## 🛠️ Quick Start\n\n### Prerequisites\n```bash\nNode.js \u003e= v14\nMongoDB\nnpm or yarn\n```\n\n### Installation\n\n1. **Clone the repository**\n```bash\ngit clone https://github.com/KGupta2601/HackThisFall_InterestFusion.git\ncd HackThisFall_InterestFusion\n```\n\n2. **Environment Setup**\n```bash\ncp .env.example .env\n# Edit .env with your configurations\n```\n\n3. **Install Dependencies**\n```bash\nnpm install\n```\n\n4. **Start Development Server**\n```bash\nnpm run dev\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e📝 Configuration Options\u003c/summary\u003e\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PORT` | Server port | 3000 |\n| `MONGODB_URI` | MongoDB connection string | mongodb://localhost:27017 |\n| `JWT_SECRET` | JWT encryption key | - |\n| `VONAGE_API_KEY` | Vonage API key for OTP | - |\n\n\u003c/details\u003e\n\n## 🏗️ Architecture\n\n```mermaid\ngraph TD\n    A[Frontend - React] --\u003e B[API Layer]\n    B --\u003e C[Authentication]\n    B --\u003e D[Interest Matching Engine]\n    B --\u003e E[User Management]\n    C --\u003e F[MongoDB]\n    D --\u003e F\n    E --\u003e F\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Check out our [Contributing Guidelines](CONTRIBUTING.md) for details on how to get started.\n\n\u003cdetails\u003e\n\u003csummary\u003e👥 Contributors\u003c/summary\u003e\n\n\u003ca href=\"https://github.com/KGupta2601/HackThisFall_InterestFusion/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=KGupta2601/HackThisFall_InterestFusion\" /\u003e\n\u003c/a\u003e\n\n\u003c/details\u003e\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\n- 📧 Email: gkashika26@gmail.com\n- 💬 [Discord Community](https://discord.gg/interestfusion)\n- 📚 [Documentation](https://docs.interestfusion.com)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Made with ❤️ by the Interest Fusion Team\n\u003c/div\u003e\n\n**CONTRIBUTING.md:**\n\n# 🤝 Contributing to Interest Fusion\n\nFirst off, thank you for considering contributing to Interest Fusion! It's people like you that make Interest Fusion such a great tool. 🌟\n\n## 📋 Table of Contents\n\n- [Code of Conduct](#code-of-conduct)\n- [Getting Started](#getting-started)\n- [Development Workflow](#development-workflow)\n- [Pull Request Process](#pull-request-process)\n- [Style Guidelines](#style-guidelines)\n- [Community](#community)\n\n## 📜 Code of Conduct\n\nWe take our open source community seriously and hold ourselves and other contributors to high standards of communication. By participating and contributing to this project, you agree to uphold our [Code of Conduct](CODE_OF_CONDUCT.md).\n\n## 🚀 Getting Started\n\n### 1. Fork the Repository\nClick the 'Fork' button at the top right of this page.\n\n### 2. Clone Your Fork\n```bash\ngit clone https://github.com/your-username/HackThisFall_InterestFusion.git\ncd HackThisFall_InterestFusion\n```\n\n### 3. Set Up Development Environment\n```bash\n# Add upstream remote\ngit remote add upstream https://github.com/KGupta2601/HackThisFall_InterestFusion.git\n\n# Install dependencies\nnpm install\n\n# Create branch for your feature\ngit checkout -b feature/your-feature-name\n```\n\n## 💻 Development Workflow\n\n1. **Pick an Issue**\n   - Look for issues labeled `good first issue` or `help wanted`\n   - Comment on the issue to let others know you're working on it\n\n2. **Create a Branch**\n   ```bash\n   git checkout -b feature/issue-number-short-description\n   ```\n\n3. **Make Changes**\n   - Write clear, commented code\n   - Follow our style guidelines\n   - Add tests for new features\n\n4. **Commit Changes**\n   ```bash\n   git add .\n   git commit -m \"type: brief description\n\n   - Detailed description\n   - Another point\n\n   Closes #123\"\n   ```\n\n   Commit types:\n   - `feat:` New feature\n   - `fix:` Bug fix\n   - `docs:` Documentation\n   - `style:` Formatting\n   - `refactor:` Code restructuring\n   - `test:` Adding tests\n   - `chore:` Maintenance\n\n## 🔄 Pull Request Process\n\n1. **Update Your Fork**\n   ```bash\n   git fetch upstream\n   git rebase upstream/main\n   ```\n\n2. **Push Changes**\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n3. **Create Pull Request**\n   - Use our PR template\n   - Link related issues\n   - Add screenshots if relevant\n\n4. **Code Review**\n   - Address review comments\n   - Keep discussions focused\n   - Be patient and respectful\n\n## 🎨 Style Guidelines\n\n### Code Style\n\n```javascript\n// Good\nfunction calculateInterestMatch(userInterests, otherInterests) {\n  return userInterests.filter(interest =\u003e \n    otherInterests.includes(interest)\n  ).length;\n}\n\n// Bad\nfunction calc(i1, i2) {\n  return i1.filter(i =\u003e i2.includes(i)).length;\n}\n```\n\n### Documentation Style\n\n```javascript\n/**\n * Calculates interest match percentage between two users\n * @param {string[]} userInterests - First user's interests\n * @param {string[]} otherInterests - Second user's interests\n * @returns {number} Match percentage from 0 to 100\n */\n```\n\n## 👥 Community\n\n- Join our [Discord](https://discord.gg/sYKpXXxmVp)\n- Follow us on [Twitter](https://x.com/InterestFusion)\n- Read our [Blog](https://blog.interestfusion.com)\n\n\n## 🎉 Recognition\n\nContributors get:\n- Recognition in our README\n- Contributor badge on our platform\n- Priority access to beta features\n- Invitation to contributor-only events\n\n---\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkgupta2601%2Fhackthisfall_interestfusion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkgupta2601%2Fhackthisfall_interestfusion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkgupta2601%2Fhackthisfall_interestfusion/lists"}