JavaScript CSS HTML Shell
Permalink
Failed to load latest commit information.
.tx Change imagery Transifex to YAML, use translated name and description Jun 16, 2017
css Fix topbar buttons in Firefox in save mode when css filter active Sep 23, 2017
data Merge pull request #4366 from openstreetmap/volcano Sep 22, 2017
dist Merge pull request #4366 from openstreetmap/volcano Sep 22, 2017
docs Updated screenshot of editing modes buttons. Dec 25, 2013
modules Replace tag documentation when tag has changed Sep 20, 2017
scripts Avoid issues with local untracked locale files in deploy.sh Jul 25, 2017
svg Add route-water icon Sep 8, 2017
test Merge branch 'esri-vintage' of https://github.com/jgravois/iD into jg… Sep 12, 2017
.eslintrc Change eslint no-unreachable-code from "error" to "warn" Sep 14, 2017
.gitattributes Add fixWinSymlinks.bat and instructions to README Apr 5, 2016
.gitignore Create .tx/tmp/ temp translation download location Jun 15, 2017
.npmignore npmignore Transifex config directory Jun 11, 2017
.travis.yml Tell travis to `npm run build` Aug 19, 2017
API.md Add hashtags API parameter and localStorage Aug 16, 2017
ARCHITECTURE.md Update ARCHITECTURE.md Nov 15, 2016
CHANGELOG.md 2.4.1 changelog Aug 26, 2017
CODE_OF_CONDUCT.md Add Code of Conduct Mar 27, 2016
CONTRIBUTING.md Remove extra word Jul 20, 2017
FAQ.md Add info about customizing colors with Stylish to the FAQ Sep 18, 2017
LICENSE.md Update date Jul 7, 2017
README.md HTTPS links and a typo Sep 12, 2017
RELEASING.md Run imagery before translations (imagery is now translated) Jun 15, 2017
build.js Change imagery Transifex to YAML, use translated name and description Jun 16, 2017
development_server.js Use cache to speed up development Feb 8, 2017
index.html Hide administrative boundaries by default Sep 19, 2017
package.json chore(package): update rollup-plugin-commonjs to version 8.2.1 Sep 8, 2017

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 jfire or bhousel on:

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

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

Thank you

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