An open API service indexing awesome lists of open source software.

https://github.com/ayush1665/find-my-pg-app


https://github.com/ayush1665/find-my-pg-app

android-application app-development lottie-animation razorpay-api react-native

Last synced: 17 days ago
JSON representation

Awesome Lists containing this project

README

          

# 🏠 Find My PG

A mobile application that helps users easily **discover and book Paying Guest (PG) accommodations** nearby.

---

## 🚀 Features

- 🔐 **User Authentication** – Secure login, registration, and OTP verification via Auth0.
- 🏡 **PG Listings** – View PG details with images, rent, and amenities
- 📍 **Search & Filter** – Find PGs by location, budget, or facilities
- 💬 **Contact Owners** – Direct call or message after booking
- ⚡ **Responsive UI** – Works smoothly across Android devices

---

## 🛠️ Tech Stack

| Layer | Technologies |
|-------|---------------|
| **Frontend (Mobile)** | React Native, React Navigation, Axios |
| **Backend** | Node.js, Express.js |
| **Database** | MongoDB |
| **Auth & Security** | AuthO, JWT, bcrypt, Nodemailer (for OTP) |
| Payment Gateway | Razorpay API |

---

## 📸 Screenshots

| Home Screen | Filter | PG Detail | Razorpay Payment | Profile Screen |
|--------------|-------------|----------------|-----------------|-----------------|
| ![Home](https://i.postimg.cc/RhbxBN1Z/screenshot-8.jpg) | ![Filter](https://i.postimg.cc/VkrHJ7wj/screenshot-1.jpg) | ![PG Details](https://i.postimg.cc/L5GLw3b0/screenshot-3.jpg) | ![Payment](https://i.postimg.cc/j55fj1V3/screenshot-4.jpg) | ![Profile](https://i.postimg.cc/sXwJ6Sy1/screenshot-5.jpg) |

---

## ⚙️ Installation & Setup

1. **Clone the repository**
```bash
git clone https://github.com/Ayush1665/Find-My-PG-App.git
cd client

2. **Install dependencies**

```bash
npm install
```

3. **Set up backend**
Go to the `server` folder, install dependencies, and start the server:

```bash
cd server
npm install
npm start
```

4. **Run the React Native app**

```bash
npx react-native start
npx react-native run-android
```
---

## 🤝 Contributing

1. Fork the repo
2. Create a new branch (`feature/your-feature`)
3. Commit and push changes
4. Open a Pull Request

---

## ⭐ Support

If you found this project helpful, give it a **⭐ on GitHub** and share it with others!