Global Day of Coderetreat Registration

Registering your event at

This year, registering your event at is easier than it has ever been! Like a lot of other community events, we’re using a Pull Request-based process for registrations:

  1. Fork the Coderetreat git repository, current status: Build Status

  2. Create a new file called $YOURCITY.json in the _data/events_gdcr2019/ of the repository. You can either:
    • Generate a file automatically by using this schema.

    • Generate a file when filling the form below. The file content will appear in Result area:

    The only required fields are:

    • title
    • url
    • date.start
    • date.end

    For, make sure you use the full name of the country. Example below:

    • United Kingdom ✅
    • UK
    • United States of America ✅
    • US
    • USA

    If you want your event to show up on our map as well, please fill out location.coordinates with the coordinates of your city. You can find them by typing the city name into Google Maps (or OSM for that matter) and extracting the coordinates from the URL.

    For Berlin, Google Maps yields the following url:,13.4009883,16.3z
                                 ^^^^^^^^^^ ^^^^^^^^^^
                                 Latitude   Longitude

    With OpenStreetMap, the URL looks like this:
                                          ^^^^^^^ ^^^^^^^
                                          Lat.    Long.
  3. If you would like to run the verification of your JSON file locally, then you must have NodeJS installed on your machine to execute the following commands:

    cd     # Change into the repository
    npm install             # Install all dependencies
    npm test                # Verify all events
  4. Submit a pull request (PR) from GitHub. Be sure your PR title is clear.

  5. Travis-CI will automatically verify that your JSON file is valid (it should show up here in the test output).

  6. The Coderetreat coordinators will then merge your request as soon as possible.

  7. Your event will appear on Where page.