Akhil27072005 / ReactCircle

ReactCircle is a full-stack social media dashboard built using the MERN stack (MongoDB, Express.js, React, Node.js). Users can register, log in, create/edit posts, comment, and manage their profiles in a secure, responsive interface.

Home Page:https://reactcircle.vercel.app/login

Repository from Github https://github.comAkhil27072005/ReactCircleRepository from Github https://github.comAkhil27072005/ReactCircle

πŸš€ ReactCircle - MERN Social Media Dashboard

ReactCircle is a fully functional, full-stack social media dashboard application built using the MERN stack (MongoDB, Express.js, React, Node.js). It simulates core functionalities of modern social platforms like Instagram or Facebook but tailored into a clean, minimal, and responsive interface.

Users can register and authenticate using JWT-based login or Google OAuth, create posts with images, interact with other users' content, comment and like posts, and manage their own profile and posts. This app showcases not only frontend UI/UX design using React and Bootstrap but also a secure and scalable backend with authentication, role validation, and cloud-based media handling via Cloudinary.


🌐 Live Demo


πŸ“Œ Features

πŸ§‘β€πŸŽ“ Authentication & Authorization

  • πŸ” Secure JWT authentication (access + refresh tokens).

  • πŸ”‘ Google OAuth 2.0 login via Passport.js integration.

  • 🧠 User session persists with refresh-token based auto-renewal.

πŸ“ Posts

  • πŸ–ΌοΈ Users can create posts with: Title, Caption, Description, Image (uploaded to Cloudinary)

  • ✏️ Ability to edit or delete your own posts.

  • πŸ”Ž View other users' posts, including interacted posts.

  • πŸ’¬ Interactions

  • ❀️ Like or Unlike any post.

  • πŸ’­ Add, Edit, and Delete your own comments on posts.

  • πŸ”ƒ View post engagement (total likes, total comments).

πŸ‘€ Profiles

  • 🧾 Each user has a personal profile displaying their posts and info.

  • πŸ› οΈ Edit profile including profile picture (Cloudinary), username, and bio.

  • πŸ” Search and view other users’ public profiles.

πŸ”Ž Search

  • πŸ”Ž Search users by name or email

πŸ› οΈ Tech Stack

🧩 Frontend

  • React
  • React Router
  • Axios
  • Bootstrap

🧩 Backend

  • Node.js + Express.js
  • MongoDB + Mongoose
  • Passport.js (Google OAuth 2.0)
  • JWT for Authentication
  • Cloudinary (image uploads)
  • Multer & multer-storage-cloudinary

πŸ§‘β€πŸ’» Setup Instructions

πŸ“¦ Backend

cd backend
npm install
npm start

πŸ’» Frontend

cd client
npm install
npm start

πŸ” Environment Variables (.env)

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

πŸš€ Deployment

  • πŸ–₯️ Frontend – Deployed on Vercel

  • 🧠 Backend – Deployed on Render

  • ☁️ Media Storage – Cloudinary


About

ReactCircle is a full-stack social media dashboard built using the MERN stack (MongoDB, Express.js, React, Node.js). Users can register, log in, create/edit posts, comment, and manage their profiles in a secure, responsive interface.

https://reactcircle.vercel.app/login


Languages

Language:JavaScript 76.8%Language:CSS 21.8%Language:HTML 1.4%