The easy-to-use OpenStreetMap editor in JavaScript.
JavaScript CSS HTML Shell
Failed to load latest commit information.
css Move fills to their own css file and class as important Feb 20, 2017
data Add Produce field Feb 20, 2017
dist Add Produce field Feb 20, 2017
docs Updated screenshot of editing modes buttons. Dec 25, 2013
modules Better detection of culture-specific locale in language list Feb 15, 2017
scripts Check in example script Dec 2, 2016
svg Refresh icons, Add save icon, navigation icons Jan 26, 2017
test Fix css link in test harness Feb 20, 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 Add endpoint class for endpoint vertices Jan 24, 2017 Update Nov 15, 2016 2.1.2 Feb 7, 2017 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 Don't need these symlinks anymore Feb 21, 2017
development_server.js Use cache to speed up development Feb 8, 2017
index.html Combine all the css files into dist/iD.css Feb 20, 2017
package.json Merge branch 'split_css' Feb 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.