Upchaar Aayog is a full-stack healthcare discovery platform focused on affordability and access. It helps users:

• find govt. scheme hospitals
• find Jan Aushadhi Kendras
• search lower-cost generic medicine alternatives (under-development)

The repository contains a Next.js frontend and a Spring Boot backend.

upchaar-aayog/
├── upchaaraayog-frontend/   # Next.js 16 + React 19 UI
└── upchaaraayog-backend/    # Spring Boot 4 + PostgreSQL

• Hospital discovery with state, district, hospital type, scheme, and speciality filters
• Jan Aushadhi Kendra search by location
• generic medicine search experience for cheaper alternatives

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS 4
• Zustand

• Spring Boot 4
• Spring Data JPA
• JdbcClient
• PostgreSQL

cd upchaaraayog-backend
./mvnw spring-boot:run

Backend default:

• port: 8080
• bind address: 0.0.0.0

cd upchaaraayog-frontend
npm install
npm run dev

Frontend default:

• port: 3000
• bind address: 0.0.0.0

Desktop:

• http://localhost:3000

Mobile on the same Wi-Fi:

• http://<your-local-ip>:3000
• example: http://192.168.1.5:3000

Frontend uses:

• NEXT_PUBLIC_API_URL

Example:

NEXT_PUBLIC_API_URL=http://192.168.1.5:8080

If this variable is missing in the browser, the frontend falls back to the current hostname with backend port 8080.

Backend uses:

• DATABASE_URL
• DATABASE_USERNAME
• DATABASE_PASSWORD

See upchaaraayog-backend/src/main/resources/application.yaml.

Important endpoints:

• GET /api/v1/hospitals/states
• GET /api/v1/hospitals/districts?state=...
• GET /api/v1/hospitals/schemes?state=...&district=...
• GET /api/v1/hospitals/specialities?state=...&district=...
• GET /api/v1/hospitals/types?state=...&district=...
• GET /api/v1/jan-aushadhi-kendra
• GET /api/v1/states
• GET /api/v1/states/{stateName}/districts

This project is meant to improve discoverability of public-health and affordable-care information. Users should still verify final eligibility, hospital availability, and medicine details through official channels before making treatment decisions.