{"id":23228731,"url":"https://github.com/akshay-9155/connectus","last_synced_at":"2026-04-13T14:31:26.494Z","repository":{"id":256174328,"uuid":"829129551","full_name":"akshay-9155/connectus","owner":"akshay-9155","description":"Welcome to the CONNECT US, a full-stack social networking platform built with the MERN (MongoDB, Express, React, Node.js) stack. This app allows users to connect, share, and interact with posts, comments, and likes, offering a seamless social media experience.","archived":false,"fork":false,"pushed_at":"2024-11-22T23:41:24.000Z","size":4923,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T18:34:47.349Z","etag":null,"topics":["expressjs","javascript","mongodb","mongodb-atlas","mongoose","nodejs","react-redux-toolkit","reactjs"],"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/akshay-9155.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}},"created_at":"2024-07-15T20:24:11.000Z","updated_at":"2024-11-22T23:41:28.000Z","dependencies_parsed_at":"2025-02-11T15:50:01.179Z","dependency_job_id":"5acb1d09-5bcc-482a-a21c-8ac511279a1c","html_url":"https://github.com/akshay-9155/connectus","commit_stats":null,"previous_names":["akshay-9155/connectus"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/akshay-9155/connectus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshay-9155%2Fconnectus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshay-9155%2Fconnectus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshay-9155%2Fconnectus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshay-9155%2Fconnectus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akshay-9155","download_url":"https://codeload.github.com/akshay-9155/connectus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akshay-9155%2Fconnectus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31757477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T13:27:56.013Z","status":"ssl_error","status_checked_at":"2026-04-13T13:21:23.512Z","response_time":93,"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":["expressjs","javascript","mongodb","mongodb-atlas","mongoose","nodejs","react-redux-toolkit","reactjs"],"created_at":"2024-12-19T01:14:53.051Z","updated_at":"2026-04-13T14:31:26.475Z","avatar_url":"https://github.com/akshay-9155.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📱 CONNECT US - Social Media App - MERN Stack\n\nWelcome to the **CONNECT US**, a full-stack social networking platform built with the **MERN (MongoDB, Express, React, Node.js)** stack. This app allows users to connect, share, and interact with posts, comments, and likes, offering a seamless social media experience.\n\n---\n\n## 🚀 Features\n\n- **User Authentication**: Secure user registration and login with JWT authentication.\n- **Post Creation \u0026 Interaction**: Users can create, edit, and delete posts, as well as like, comment, and reply to other users’ posts.\n- **Real-time Updates**: Stay updated with live posts and comments using websockets (or long-polling).\n- **Profile Management**: Customize profiles with bio, profile picture, and personal details.\n- **Follow \u0026 Unfollow**: Discover and follow other users.\n- **Responsive Design**: Optimized for both desktop and mobile devices.\n\n---\n\n## 🛠️ Technologies Used\n\n### Frontend:\n\n- **React.js**: A dynamic user interface built with React and hooks.\n- **Redux**: For state management across the application.\n- **React Router**: Navigation between different components.\n- **Tailwind CSS**: Utility-first CSS framework for rapid UI development.\n\n### Backend:\n\n- **Node.js**: JavaScript runtime environment for server-side logic.\n- **Express.js**: Fast and lightweight web framework for building APIs.\n- **MongoDB**: NoSQL database for storing user data, posts, and comments.\n- **Mongoose**: Object Data Modeling (ODM) library for MongoDB.\n\n### Authentication:\n\n- **JWT (JSON Web Tokens)**: For secure authentication and session management.\n\n### Cloud Services:\n\n- **Cloudinary**: For image storage and management.\n- **Vercel**: For backend and frontend deployment.\n\n---\n\n## 📸 Screenshots\n\n### Register Page\n\n![Register-page Screenshot](./frontend/public/RegisterPage.png)\n\n### Login Page\n\n![Register-page Screenshot](./frontend/public/LoginPage.png)\n\n### Home Page\n\n![Home Page Screenshot](./frontend/public/Homepage.png)\n\n### Profile Page\n\n![Register-page Screenshot](./frontend/public/ProfilePage.png)\n\n---\n\n## ⚙️ Installation \u0026 Setup\n\n### Prerequisites:\n\n- **Node.js** and **npm** installed on your system.\n- **MongoDB** installed or access to a cloud-based MongoDB instance.\n\n### Backend Setup:\n\nNavigate to the backend folder:\n\n```bash\ncd backend\n```\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nCreate a .env file for environment variables:\n\n```bash\ntouch .env\n```\n\nAdd the following variables to the .env file:\n\n```bash\nPORT=port_number\nMONGODB_PASSWORD=your_mongodb_password\nMONGO_URI=your_mongo_db_uri\nJWT_SECRET=your_secret_key\n\nCLOUDINARY_CLOUD_NAME=your_cloudinary_name\nCLOUDINARY_API_KEY=your_cloudinary_api_key\nCLOUDINARY_API_SECRET=your_cloudinary_api_secret\n```\n\nStart the backend server:\n\n```bash\nnpm run dev\n```\n\n### Frontend Setup:\nNavigate to the frontend folder:\n\n```bash\ncd ../frontend\n```\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nInstall Tailwind CSS by following [Tailwind Setup Guide](https://tailwindcss.com/docs/guides/vite).\n\nStart the frontend server:\n\n```bash\nnpm run dev\n```\n\n## Access the App\n\n- **Frontend**: Visit [http://localhost:5173](http://localhost:5173) in your browser.\n- **Backend**: The backend runs on [http://localhost:8080](http://localhost:8080) by default.\n\n🌐 **Live Demo**\n\nYou can check out the live version of the app here: [Live Demo](URL_OF_LIVE_DEMO) \u003c!-- Add deployed url --\u003e\n\n## 🤝 Contributing\n#### Contributions are welcome! If you'd like to contribute to the project, follow these steps:\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## 💬 Contact\n### For any questions, feel free to reach out at:\n\n- Email: [akshayanand9162@gmail.com](mailto:akshayanand9162@gmail.com)\n- GitHub: [akshay-9155](https://github.com/akshay-9155)\n\n## 🙌 Acknowledgements\n### Special thanks to all the contributors and open-source libraries that made this project possible.\n\n## 📚 Project Structure\n### Here’s a quick overview of the project structure:\n\n```bash\nsocialMediaApp/\n│\n├── backend/             # Backend (Node.js/Express) code\n│   ├── config/          # Configuration (e.g., database)\n│   ├── controllers/     # Route logic\n│   ├── models/          # Mongoose schemas (User, Post, Comment)\n│   ├── routes/          # API routes\n│   ├── utils/           # Utility functions (e.g., JWT handling)\n│   ├── public/          # temporarily store images\n│   ├── app.js           # middlewares and APIs call\n│   |── index.js         # Entry point for the backend server\n│   └── .env             # Environment variables\n│\n├── frontend/            # Frontend (React.js) code\n│   ├── public/\n│   ├── utils/           # constants.jsx\n│   ├── src/\n│   │   ├── assets/\n│   │   ├── components/  # React components\n│   │   ├── redux/       # Redux slices, actions, reducers\n│   │   ├── hooks/       # custom hooks\n│   │   ├── App.js      \n│   │   ├── index.css    \n│   │   ├── main.js      # Root component\n│   │   └── index.html     # Entry point for the React app\n│   └── tailwind.config.js # Tailwind CSS configuration\n│\n├── package.json         # npm dependencies\n└── README.md            # Project documentation\n\n```\n\n## ✨ Features Overview\n- **Authentication**\n    - JWT-based authentication to handle secure login and signup.\n    - Passwords are hashed using bcrypt for security.\n- **Post Management**\n    - Users can create, edit, delete, and like posts.\n    - Posts can include text and images (uploaded to Cloudinary).\n- **Commenting \u0026 Replies**\n    - Nested comment structure with users able to comment and reply to posts.\n    - Users can like and delete comments.\n- **Follow \u0026 Feed System**\n    - Follow system where users can follow/unfollow others.\n    - A personalized feed showing posts from followed users.\n## 📝 Todo\n- Add notifications for likes, comments, and follows.\n- Add search functionality.\n- Implement real-time chat.\n## 🧑‍💻 Future Improvements\n- Real-time Features: Add WebSocket support for real-time notifications.\n- Story Feature: Allow users to post time-limited \"stories.\"\n- PWA Support: Make the app installable as a Progressive Web App (PWA).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakshay-9155%2Fconnectus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakshay-9155%2Fconnectus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakshay-9155%2Fconnectus/lists"}