A mobile-first Progressive Web App that helps users discover nearby restaurants through random selection.
https://kainsaan-production.up.railway.app/
Kain Saan is a location-based restaurant finder that uses geolocation to search for dining establishments within a configurable radius. Users can randomly select from nearby restaurants displayed on an interactive map.
Backend
- Django 5.0
- PostgreSQL
- OpenStreetMap Overpass API
Frontend
- Django Templates
- Tailwind CSS
- Vanilla JavaScript
- Google Maps JavaScript API
Infrastructure
- Docker & Docker Compose
- GitHub Actions
- Gunicorn
- Clone the repository:
git clone https://github.com/jabtechh/kainsaan.git
cd kainsaan- Copy environment file:
cp .env.example .env- Add your Google Maps API key to
.env:
GOOGLE_MAPS_API_KEY=your-api-key-here- Run with Docker:
docker-compose up --build- Open
http://localhost:8000
I welcome contributions to Kain Saan. Feel free to create an issue regarding any bugs or desired features, and I'll respond when possible. If you want to contribute code, please fork this repository and create a pull request.
Please note that contributions should focus on the frontend and application logic. The external API integrations and service layer code should remain as-is for security and stability reasons.
- Michelin-starred restaurant filter (search for awarded establishments nearby)
- Nearest carinderia finder (local eateries)
MIT License