ApnaPG — Full-stack PG marketplace

ApnaPG is an OLX-style PG/coliving marketplace with beautiful responsive discovery UI, owner listings, instant or approval-based bookings, and booking-amount + security-deposit payments.

Project folders

• Frontend: project root (React 19 + Vinext/Vite)
• Backend: backend/ (Java 17 + Spring Boot + Oracle)

Start frontend

npm install
npm run dev

Open http://localhost:3000 (or the port printed by Vite). The UI includes interactive search, gender/budget filters, favourites, property details, and a complete demo checkout.

Start backend

Read backend/README.md, create the Oracle user, then:

cd backend
mvn spring-boot:run

The current frontend uses realistic local demo listings so it is immediately viewable. Replace the property array in app/page.tsx with calls to http://localhost:8080/api/properties when connecting both layers.

Production notes

• Keep Oracle, JWT, Razorpay and image-host credentials in environment variables.
• Use Razorpay Test Mode first and verify signatures server-side before marking bookings paid.
• Add KYC/property verification, refund rules and webhook event reconciliation before accepting live users.