The easy-to-use OpenStreetMap editor in JavaScript.
JavaScript HTML CSS Other
Latest commit 6d68c30 Sep 25, 2016 @bhousel bhousel committed on GitHub Merge pull request #3451 from jasonharrison/patch-1
though -> thought
Permalink
Failed to load latest commit information.
css Add some padding to the deselect buttons Jul 31, 2016
data Add preset man_made=pumping_station Sep 5, 2016
dist Add preset man_made=pumping_station Sep 5, 2016
docs Updated screenshot of editing modes buttons. Dec 25, 2013
js/lib Cleanup: removing unnecessary independent libs (#3342) Aug 11, 2016
modules Removing parseInt call of a number Sep 2, 2016
svg Improved detour icon Aug 3, 2016
test Rename confirm -> uiconfirm and import to save.js Aug 24, 2016
.eslintrc Enable radix eslint rule Sep 2, 2016
.gitattributes Add fixWinSymlinks.bat and instructions to README Apr 5, 2016
.gitignore Cleanup: removing unnecessary independent libs (#3342) Aug 11, 2016
.npmignore Add .npmignore that doesn't ignore stuff in dist/ Feb 19, 2016
.travis.yml Clean first Jul 6, 2016
API.md Replace iD global with iD.Context() module (#3254) Jul 19, 2016
ARCHITECTURE.md iD.svg.Surface -> iD.svg.Layers Feb 24, 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 one-shot build (#3266) Aug 10, 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 Merge pull request #3339 from McKaneAndrus/patch-json-schema Aug 16, 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 one-shot build (#3266) Aug 10, 2016
land.html Create a dist directory Apr 22, 2013
package.json chore(package): update eslint to version 3.5.0 Sep 9, 2016
replaceStuff.js Fixing Interdependecy between ui.preset and ui.core Jul 2, 2016
rollup.config.js one-shot build (#3266) Aug 10, 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.