🐦 Twitter (X) Clone – Full Stack MERN App

A full-featured Twitter (X) Clone built using the MERN stack (MongoDB, Express, React, Node.js). Includes real-time tweets, likes, comments, user follow system, profile customization, and mobile-friendly design.

🚀 Ideal for developers exploring full-stack social media app architecture with MongoDB Atlas, Cloudinary, and Tailwind CSS.

Stay tuned for a hosted version on Vercel or Netlify!

• ✨ Features
• ⚙️ Technologies Used
• 📦 Installation
• 🚀 Usage
• 🖼️ Screenshots
• 🤝 Contributing
• 📄 License

• 🔐 Authentication – Sign up, log in, JWT-based sessions
• 📝 Tweet System – Post, edit, delete tweets with text/media
• ❤️ Like + Comment – Interact with posts in real-time
• 🧑‍🤝‍🧑 Follow System – Follow/unfollow and personalized feeds
• 🖼️ Profile Customization – Bio, avatar, cover photo
• 🔔 Notifications – View activity updates
• 📱 Responsive UI – Mobile-first with Tailwind CSS
• ☁️ Cloud Storage – Cloudinary integration for images
• ⚡ Real-Time Updates – Live interaction with no refresh

• Node.js (v18+)
• MongoDB Atlas account
• Cloudinary account

cd backend
npm install

cd frontend
npm install
npm run dev

MONGODB_URI=mongodb+srv://...
PORT=8000
JWT_SECRET=your_jwt_secret_here
NODE_ENV=development 
CLOUDINARY_CLOUD_NAME=...
CLOUDINARY_API_KEY=...
CLOUDINARY_API_SECRET=...

• 🧑‍💼 Sign up or log in to your account
• 🐦 Post tweets and engage with others
• 🔁 Follow users and view their timeline
• 💬 Like, comment, and get notified instantly

Visit: http://localhost:3000

Page	Preview
Profile Page
Home Feed
Notifications Page
Auth/Login Page

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

We welcome all contributions! 🙌

Licensed under the MIT License.

Project Maintainer: @kgnio
DMs and collabs are welcome!