A modern platform that helps students and working professionals quickly discover nearby hostels and PG accommodations. Users can search, filter, and compare PGs based on location, price, and amenities. Built with React and styled with Tailwind CSS for a responsive and elegant UI.
- Secure login and signup using JWT authentication and Bcrypt.js for password hashing.
- Two roles: Tenant and Agent.
- Search PGs/Hostels by location, budget, and amenities.
- Apply filters (e.g., price range, single/double occupancy, food included).
- Save favorite PGs for quick access.
- Book visits or contact property owners directly.
- Update profile details.
- Add, update, or remove PG listings.
- Upload images, set rent, facilities, and availability.
- Manage tenant requests and inquiries.
- Track occupancy and bookings.
- Mobile-friendly responsive design.
- Interactive maps integration for nearby PG search.
- Secure profile management for both tenants and agents.
- React
- Zustand
- Tailwind CSS
- Socket.io
- Node.js
- Express
- Socket.io
- MongoDB
- AWS S3 Bucket
-
Clone the repository:
git clone https://github.com/devanshkansagra/FindPG.git
-
Go to backend and run
cd backend npm install -
Go to frontend and run
cd frontend npm install -
Setup .env file
- Backend
ORIGIN=http://localhost:5173 # (or your frontend deployment url) SERVER=http://localhost:4000 # (or your backend deployment url) MONGDB_URI="mongodb://localhost:27017/FindPG" # (or MongDB Atlas URL) ACCESS_TOKEN_SECRET=3f8d1c7e-9b2a-4e6e-8c1a-7a5e2d4b9c3f #(Recommended to generate random) ACCESS_TOKEN_EXPIRY=3599s REFRESH_TOKEN_SECRET=68ceaf35-3cd8-8321-b6b3-9572e0df983f #(Recommended to generate random) REFRESH_TOKEN_EXPIRY=7d AWS_BUCKET_NAME= AWS_BUCKET_REGION= AWS_ACCESS_KEY= AWS_SECRET_ACCESS_KEY= GMAIL_USER= GMAIL_APP_PASSWORD=
- Frontend
VITE_SERVER_ORIGIN=http://localhost:4000
-
To Run Project
cd frontend npm start run cd backend npm run dev