Ruby Map

Whilst travelling to other cities I've often wondered: "What's going on in the local Ruby community?" To answer this question, hopefully fellow Rubyists will share their organization / meetup / events and anyone interested will be able to discover the Ruby world around them! Sometimes folks are interested in finding a new gig, in a new location. Ruby Map might be useful for that too, if companies share if they are hiring.

Your company / meetup / event is missing?

What if your company / meetup / event is missing on the map? No problem, just send us a PR and it will get added asap. An example PR can be found here.

Please try to maintain the order-by-name of the yaml file, to prevent merge conflicts.

Each entry can also have a description of one or two sentences, and a photo (600×350) and a logo (96×96) stored in app/assets/images/organizations.

Data sources

Most meetups and events, with their photos and logos, come from RubyEvents.org (github.com/rubyevents/rubyevents). The card for each of these entries links back to RubyEvents. To update them, clone that repository and run:

bin/rails "rubyevents:import[path/to/rubyevents]"

The importer adds any series that is missing, at the place of its next or latest edition. It skips conferences with no edition since 2024. Entries that already exist keep their details. To stop a series from being added again, list its id in data/seeds/rubyevents_ignored.yml.

For other entries, bin/rails organizations:media downloads the share image (og:image) and the icon from the organization's website. It identifies itself as RubyMap, follows robots.txt and skips meetup.com. To have an image removed or replaced, open an issue or a pull request.

The descriptions were drafted by an AI model from each organization's website and its RubyEvents text. Corrections are welcome.

Development

Ruby Map is a Rails app backed by PostgreSQL with PostGIS. The map is drawn with MapLibre GL JS using OpenFreeMap tiles of OpenStreetMap data, and addresses are geocoded with Nominatim. None of these need an API key.

You need Ruby (see .ruby-version) and Docker. Start PostGIS, then set up the app:

docker compose up -d
bin/setup

bin/setup creates the database and starts the server at http://localhost:3000. To load the organizations, run:

bin/rails db:seed

Seeding geocodes each address once, at one request per second, so a first run takes about five minutes. Later runs only geocode addresses that are new.

Run the tests and linters with:

bundle exec rspec
bundle exec standardrb
bundle exec rake yamllint

Deployment

The app runs on Dokku with the Heroku Ruby buildpack pinned in .buildpacks. On each deploy, the release process in Procfile runs migrations and syncs data/seeds/organizations.yml into the database. Existing locations keep their coordinates and only new addresses are geocoded.

It expects DATABASE_URL (PostgreSQL with PostGIS), REDIS_URL, RAILS_MASTER_KEY and, optionally, SENTRY_DSN.