Pariwar Hamro — A Family Meetup Gallery & Chat App

🧠 Motivation

We regularly meet with close family friends, enjoying meals, games, and memorable activities together. Over time, we realized that all the fun photos taken during these gatherings were scattered and unorganized. This app was born to give those memories a permanent, structured home — a place to store, share, and revisit our beautiful moments. Additionally, it adds interactivity through chats and AI, making our digital family space more engaging.

✨ Features

📷 Photo Gallery

Interactive image viewing using react-image-gallery
Upload via file picker or drag-and-drop
Only logged-in users can upload/delete photos
Images stored in Cloudinary & linked to users
Supports JPEG/PNG, max size 5MB
Real-time error/success notifications with react-hot-toast

🔐 Authentication

NextAuth.js with CredentialsProvider & GoogleProvider
User session required for uploads and AI chat

💬 Two Types of Chat

1. Real-Time Socket.io Chat

Built with Node.js, Express.js, Socket.IO
Public/private messaging with real-time updates
Auto-assign names, optional username registration
Responsive UI, "You" indicator
Deployed on Render
🔗 Socket Chat Backend GitHub

2. OpenAI Chat (AI Assistant)

Backend: Python (Flask) + GPT-3.5-turbo
Prompt-based responses (max 50 tokens)
Only accessible to logged-in users
🔗 OpenAI Chat GitHub

🛠️ Tech Stack

Frontend: Next.js (TypeScript), Bootstrap 5, React Icons, React Image Gallery, React Hot Toast
Backend: NextAuth.js, MongoDB via Mongoose, Cloudinary
Chat Backends: Node.js + Express.js + Socket.IO; Python + Flask + OpenAI API
API Routes: POST /api/images, DELETE /api/images/:id

📦 Dependencies

"dependencies": {
  "bcryptjs": "^3.0.2",
  "bootstrap": "^5.3.6",
  "cloudinary": "^2.6.1",
  "mongodb": "^6.16.0",
  "mongoose": "^8.14.1",
  "next-auth": "^4.24.11",
  "next-connect": "^1.0.0",
  "react-hot-toast": "^2.5.2",
  "react-icons": "^5.5.0",
  "react-image-gallery": "^1.4.0",
  "socket.io-client": "^4.8.1"
},
"devDependencies": {
  "typescript": "^5"
}

🚀 Getting Started Locally

Clone the repo: git clone https://github.com/your-username/pariwar-hamro.git
Navigate: cd pariwar-hamro
Install dependencies: npm install
Run locally: npm run dev

🔗 Links

🙏 Thanks to open-source libraries, APIs, and the amazing family & friends who inspired this app.

"This is a private social hub built for families or close friend groups to share memories, chat, and interact — all in a secure and cozy environment."

Happy coding and nostalgic sharing! ❤️