The easy-to-use OpenStreetMap editor in JavaScript.
JavaScript CSS HTML Shell
Failed to load latest commit information.
css Fix preset icons for right-to-left languages Jan 20, 2017
data Cleanups and rename service nominatim -> geocoder Jan 17, 2017
dist Cleanups and rename service nominatim -> geocoder Jan 17, 2017
docs Updated screenshot of editing modes buttons. Dec 25, 2013
modules Use 'pt' wiki pages in 'pt-BR' iD localization Jan 20, 2017
scripts Check in example script Dec 2, 2016
svg Add reflect icons Dec 16, 2016
test Fix service name nominatim -> geocoder Jan 17, 2017
.eslintrc no-native-reassign -> no-global-assign Oct 29, 2016
.gitattributes Add fixWinSymlinks.bat and instructions to README Apr 5, 2016
.gitignore Eliminate symlinks in repository - shelljs/shx can make them Nov 30, 2016
.npmignore npmignore a few more things Oct 31, 2016
.travis.yml Add node 7 to Travis build matrix Nov 23, 2016 Use live bound object for presets object, change context.presets() ge… Nov 14, 2016 Update Nov 15, 2016 Update CHANGELOG for 2.0.2 Dec 22, 2016 Add Code of Conduct Mar 27, 2016 Bye Bye Makefile Oct 25, 2016 fix connection.js to osm.js in FAQ Nov 26, 2016
LICENSE Add license title Jun 29, 2016 Fix lib export, flatten names in tests and docs Oct 5, 2016 Add note for Windows users about symbolic links Dec 2, 2016 Remove checkboxes, remove escaped markdown chars Nov 22, 2016
build.js const with for-of not actually ok in all version of node 4 Dec 2, 2016
development_server.js Watch data folder too Oct 26, 2016
index.html Use live bound object for presets object, change context.presets() ge… Nov 14, 2016
package.json chore(package): update mapillary-js to version 2.4.0 Jan 20, 2017

iD - friendly JavaScript editor for OpenStreetMap

Build Status


  • iD is a JavaScript OpenStreetMap editor.
  • It's intentionally simple. It lets you do the most basic tasks while not breaking other people's data.
  • It supports all popular modern desktop browsers: Chrome, Firefox, Safari, Opera, Edge, and IE11.
  • iD is not yet designed for mobile browsers, but this is something we hope to add!
  • Data is rendered with d3.js.


Come on in, the water's lovely. More help? Ping jfire or bhousel on:


  • Node.js version 4 or newer
  • git for your platform
    • Note for Windows users:
      • Edit $HOME\.gitconfig:
        Add these lines to avoid checking in files with CRLF newlines
            autocrlf = input


Note: Windows users should run these steps in a shell started with "Run as administrator". This is only necessary the first time so that the build process can create symbolic links.

To run the current development version of iD on your own computer:

  1. Create a local git clone of the project, then cd into the project folder
  2. Run npm install (this will run the prepublish script that builds everything)
  3. Run npm start
  4. Open http://localhost:8080/ in a web browser

For guidance on building a packaged version, running tests, and contributing to development, see


iD is available under the ISC License. It includes d3.js, which BSD-licensed.

Thank you

Initial development of iD was made possible by a grant of the Knight Foundation.