iD - friendly JavaScript editor for OpenStreetMap

Basics

• 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.

Participate!

• Read the project Code of Conduct and remember to be nice to one another.
• Read up on Contributing and the code style of iD.
• See open issues in the issue tracker if you're looking for something to do.
• Translate!
• Test a prerelease version of iD:
  • Stable mirror of release branch: http://openstreetmap.us/iD/release
  • Development mirror of master branch: http://openstreetmap.us/iD/master

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

• OpenStreetMap US Slack (#dev or #general channels)
• OpenStreetMap IRC (irc.oftc.net, in #iD or #osm-dev or #osm)
• OpenStreetMap dev mailing list

Prerequisites

• 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
      

      [core]
      autocrlf = input

Installation

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. (Windows Only) Run fixWinSymlinks.bat. This script will prompt for Administrator rights. see also: http://stackoverflow.com/questions/5917249/git-symlinks-in-windows
3. Run npm install (this will run the prepublish script that builds everything)
4. Run npm start
5. Open http://localhost:8080/ in a web browser

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

License

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.