01
Add a fountain
Know a pulpulak that is not on the map? Submit it in under a minute.
- Open the map and click + Add fountain
- Tap the map to pin the exact location
- Fill in the name, description, and accessibility notes
- Optionally attach a photo
- Submit — it appears on the map after review
02
Rate fountains
Rate each fountain on water quality, cleanliness, and accessibility. Ratings help visitors know what to expect.
One rating per IP address per fountain.
03
Fork for your country
The codebase is generic — only the seed data is Armenia-specific.
- Fork the repo on GitHub
- Create a Supabase project (free tier is fine)
- Run the migration SQL
- Add your fountains to
data/fountains.json - Run
npm run seed - Deploy to Vercel
04
Public API
All approved fountains are available as GeoJSON, free and unauthenticated.
# All approved fountains
GET /api/fountains
GET /api/fountains
# Filter by country
GET /api/fountains?country=Armenia
GET /api/fountains?country=Armenia
Returns a standard GeoJSON FeatureCollection with fountain properties and average ratings.