💡 X / Twitter Clone

A fully functional Twitter clone built with the MERN stack, featuring real-time updates and a responsive design.

🌟 Features

• ✅ Create and share posts
• ✅ Like and unlike posts
• ✅ Follow and unfollow users
• ✅ Real-time notifications
• ✅ Customizable user profiles
• 🚧 Secure chat feature (coming soon)
• 🚧 Marketplace for college items (planned)

🚀 Demo

Check out the live demo: Twitter Clone Demo

Note:

• The project is hosted on render.com with a free plan.
• Free instances may spin down with inactivity, causing request delays of up to 50 seconds or more.
• The entire repo (frontend and backend) is hosted together, which is not a best practice but acceptable for side projects.

---

🛠️ Tech StackStack Used

Extra Stuff You Should Know About

Cloudinary - for storing images

📸 Screenshots

More to See

Will add soon...

🏁 Getting Started

Pre-requisites

To start development, ensure you have the following prerequisites installed:

• Node.js
• Git

To Get Started

1. Clone the repository:

   git clone https://github.com/muqeeth26832/twitter-clone.git

2. Install dependencies (check out the package.json for more details):

   npm install 

   cd frontend
   npm install

3. Set up the .env file in the root of the project:

   MONGO_URI=your_mongodb_uri
   PORT=8000
   JWT_SECRET=your_secret
   NODE_ENV=development 
   CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
   CLOUDINARY_API_SECRET=your_cloudinary_api_secret
   CLOUDINARY_API_KEY=your_cloudinary_api_key
   

4. Start the backend server:

   npm run dev

5. Start the frontend:

   npm run dev

6. Go to http://localhost:8000 or http://localhost:5000

You can now develop! 😊

🔮 Future Plans

Some thing that is held by a college for college students I want it to be open source.

• I want to add secure chat feature
• A page where one can post items he is selling (good for my college)
• A page for College Events Notifications( I dont check my emails that often 😅 )

Student features - (College would not like these)

• 🤓 A page where one can see anonymouse review of a course or elevtive or prof. (helps student select additional courses)
• 💪 A flex page one can flex (gym , internships , ....)
• 😅 A page to access older question papers
• page for newbies (freshers)
• 🚀 info about interns , sports facilities ....

It could make the students have a strong community. Makes

Well these might seem like a lot to have but its better to have as it saves one from a lot of spam mails.

Idk but may be in a new project ig.

If you want to contribute contact me. On git hub.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request