The easy-to-use OpenStreetMap editor in JavaScript.
JavaScript HTML CSS Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css Add some padding to the deselect buttons Jul 31, 2016
data Adjust fields (building->building_area), run make for yoga preset Aug 21, 2016
dist Adjust fields (building->building_area), run make for yoga preset Aug 21, 2016
docs Updated screenshot of editing modes buttons. Dec 25, 2013
js/lib Cleanup: removing unnecessary independent libs (#3342) Aug 11, 2016
modules Rename confirm -> uiconfirm and import to save.js Aug 24, 2016
svg Improved detour icon Aug 3, 2016
test Rename confirm -> uiconfirm and import to save.js Aug 24, 2016
.eslintrc Cleanup: removing unnecessary independent libs (#3342) Aug 11, 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 Update Mapbox Satellite imagery request link Apr 29, 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.4.0 Aug 26, 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.