🐦 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.

---

---

🌐 Live Demo (Coming Soon)

Stay tuned for a hosted version on Vercel or Netlify!

---

📚 Table of Contents

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

---

✨ Features

• 🔐 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

---

⚙️ Technologies Used

Technology	Role
MongoDB Atlas	Database (NoSQL)
Express.js	Backend framework
React.js	Frontend UI
Node.js	Server runtime
Tailwind CSS	Styling system
DaisyUI	UI components
Cloudinary	Media storage

---

📦 Installation

🔧 Prerequisites

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

🔌 Backend Setup

cd backend
npm install

🎨 Frontend Setup

cd frontend
npm install
npm run dev

🔐 Environment Variables (backend/.env)

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

---

🚀 Usage

• 🧑‍💼 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

---

🖼️ Screenshots

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

---

🤝 Contributing

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! 🙌

---

📄 License

Licensed under the MIT License.

---

📬 Contact

Project Maintainer: @kgnio
DMs and collabs are welcome!