OpenStreetMap
iD - friendly JavaScript editor forBasics
- 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!
- Read the project Code of Conduct and remember to be nice to one another.
- Read up on Contributing and the code style of iD.
- See open issues in the issue tracker if you're looking for something to do.
- Translate!
- Test a prerelease version of iD:
- Stable mirror of
release
branch: http://openstreetmap.us/iD/release - Development mirror of
master
branch: http://openstreetmap.us/iD/master
- Stable mirror of
Come on in, the water's lovely. More help? Ping jfire
or bhousel
on:
- OpenStreetMap US Slack
(
#dev
or#general
channels) - OpenStreetMap IRC
(
irc.oftc.net
, in#iD
or#osm-dev
or#osm
) - OpenStreetMap
dev
mailing list
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
- Edit
- Note for Windows users:
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:
- Create a local
git clone
of the project, thencd
into the project folder - Run
npm install
(this will run theprepublish
script that builds everything) - Run
npm start
- 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.