Skip to content
The easy-to-use OpenStreetMap editor in JavaScript.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.tx Add community index to transifex config file Dec 27, 2018
css
data Remove Curb field from crossings (close #6078) Mar 21, 2019
dist Add Raised Curb and Rolled Curb presets (close #6080) Mar 21, 2019
docs Updated screenshot of editing modes buttons. Dec 25, 2013
modules Preserve directionality of sided way when joining to non-sided ways Mar 22, 2019
scripts
svg
test
.editorconfig
.eslintrc Remove babel-eslint parser (not needed since we removed flow) Apr 2, 2018
.gitattributes Update .gitattributes to use lf eol for .js files Jan 21, 2019
.gitignore
.npmignore
.travis.yml
API.md
ARCHITECTURE.md WIP merge 'gpx' and 'mvt' layers into single 'data' layer Aug 17, 2018
CHANGELOG.md
CODE_OF_CONDUCT.md Add Code of Conduct Mar 27, 2016
CONTRIBUTING.md Improves CONTRIBUTING.md Dec 31, 2018
FAQ.md Add info about customizing colors with Stylish to the FAQ Sep 18, 2017
LICENSE.md Update date Jul 7, 2017
README.md
RELEASING.md Add links and fix git command in the release instructions Feb 21, 2019
build_css.js
build_data.js Upgrade to name-suggestion-index v2 Mar 21, 2019
build_src.js
development_server.js Minor cleanups to some of the build scripts Mar 8, 2019
index.html
package.json fix: pin sinon to 7.2.7 Mar 21, 2019

README.md

iD - friendly JavaScript editor for OpenStreetMap

Build Status Greenkeeper badge

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!

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

Prerequisites

  • Node.js version 6 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

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:

Cloning the repository

The repository is reasonably large, and it's unlikely that you need the full history (~200 MB). If you are happy to wait for it all to download, run:

git clone https://github.com/openstreetmap/iD.git

To clone only the most recent version, instead use a 'shallow clone':

git clone --depth=1 https://github.com/openstreetmap/iD.git

If you want to add in the full history later on, perhaps to run git blame or git log, run git fetch --depth=1000000

Building iD

  1. cd into the newly cloned project folder
  2. Run npm install
  3. Run npm run all
  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. See the LICENSE.md file for more details.

iD also bundles portions of the following open source software.

Thank you

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

You can’t perform that action at this time.