Get involved

Contribute

Three ways to help: add a fountain, improve data quality, or fork the project for your country.

01

Add a fountain

Know a pulpulak that is not on the map? Submit it in under a minute.

  1. Open the map and click + Add fountain
  2. Tap the map to pin the exact location
  3. Fill in the name, description, and accessibility notes
  4. Optionally attach a photo
  5. Submit — it appears on the map after review
Open the map
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.

  1. Fork the repo on GitHub
  2. Create a Supabase project (free tier is fine)
  3. Run the migration SQL
  4. Add your fountains to data/fountains.json
  5. Run npm run seed
  6. Deploy to Vercel
GitHub repo
04

Public API

All approved fountains are available as GeoJSON, free and unauthenticated.

# All approved fountains
GET /api/fountains
# Filter by country
GET /api/fountains?country=Armenia

Returns a standard GeoJSON FeatureCollection with fountain properties and average ratings.

Try the API →