The easy-to-use OpenStreetMap editor in JavaScript.
JavaScript HTML CSS Other
Permalink
Failed to load latest commit information.
css Fields mostly working (but not dispatch/update) Sep 21, 2016
data Merge branch 'master' into d3-v4 Sep 28, 2016
dist Merge branch 'master' into d3-v4 Sep 28, 2016
docs Updated screenshot of editing modes buttons. Dec 25, 2013
modules A few changes to make things work and test with Node 4, 5, 6 Sep 29, 2016
svg Improved detour icon Aug 3, 2016
test Add some namespaces to test labels Sep 13, 2016
.eslintrc Enable radix eslint rule Sep 2, 2016
.gitattributes Add fixWinSymlinks.bat and instructions to README Apr 5, 2016
.gitignore gitignore sourcemap, add dependencies for gazer and ecstatic Aug 30, 2016
.npmignore Add .npmignore that doesn't ignore stuff in dist/ Feb 19, 2016
.travis.yml A few changes to make things work and test with Node 4, 5, 6 Sep 29, 2016
API.md Replace iD global with iD.Context() module (#3254) Jul 19, 2016
ARCHITECTURE.md Begin d3 v4 update Aug 21, 2016
CHANGELOG.md 1.9.7 CHANGELOG Jul 16, 2016
CODE_OF_CONDUCT.md Add Code of Conduct Mar 27, 2016
CONTRIBUTING.md Javascript -> JavaScript, remove outdated contributing instructions Aug 11, 2016
FAQ.md though -> thought Sep 24, 2016
LICENSE Add license title Jun 29, 2016
Makefile Remove more of the Makefile Sep 2, 2016
NOTES.md Javascript -> JavaScript, remove outdated contributing instructions Aug 11, 2016
README.md Simplified macOS setup instructions Aug 20, 2016
RELEASING.md 1.9.4 May 4, 2016
build.js Remove more of the Makefile Sep 2, 2016
development_server.js Merge branch 'd3-v4' of github.com:openstreetmap/iD into d3-v4 Sep 4, 2016
fixWinSymlinks.bat Add fixWinSymlinks.bat and instructions to README Apr 5, 2016
img add symbolic link to img so IE can find cursors Nov 26, 2015
index.html Fix source toggle, fix way drawing Sep 4, 2016
land.html Create a dist directory Apr 22, 2013
package.json chore(package): update eslint to version 3.6.1 Sep 29, 2016

README.md

iD - friendly JavaScript editor for OpenStreetMap

Build Status

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 jfire or bhousel on OpenStreetMap IRC (irc.oftc.net, in #iD or #osm-dev or #osm) or on the OpenStreetMap dev mailing list.

Prerequisites

  • Node.js version 4 or newer
  • Command line development tools (make, git, and a compiler) for your platform
    • Ubuntu:
      • sudo apt-get install build-essential git
    • macOS:
      • Run xcode-select --install from a command line or install Xcode
    • Windows (Cygwin):
      • Install Git for Windows
      • Install Cygwin - choose default packages + make, wget, apache2 (needed for updated mime type list)
      • Optionally, install apt-cyg for managing your Cygwin packages
      • Edit ~/.bashrc:
        Put Git for Windows before Cygwin in PATH, otherwise npm install may fail to fetch git repositories
        export PATH=/cygdrive/c/Program\ Files/Git/mingw64/bin/:$PATH
      • Edit ~/.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
  4. Run make
  5. Start the local web server npm run-script web
  6. 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.