https://github.com/tilemill-project/tilemill

TileMill is a modern map design studio
https://github.com/tilemill-project/tilemill

mapbox mapnik openstreetmap osm tilemill

Last synced: 29 days ago
JSON representation

TileMill is a modern map design studio

• Host: GitHub
• URL: https://github.com/tilemill-project/tilemill
• Owner: tilemill-project
• License: bsd-3-clause
• Created: 2010-07-05T16:59:47.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2023-11-05T18:10:50.000Z (about 1 year ago)
• Last Synced: 2024-10-01T23:23:53.293Z (about 1 month ago)
• Topics: mapbox, mapnik, openstreetmap, osm, tilemill
• Language: JavaScript
• Homepage: https://tilemill-project.github.io/tilemill/
• Size: 117 MB
• Stars: 3,115
• Watchers: 160
• Forks: 527
• Open Issues: 409
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Latest Status - June 13, 2021

We are looking for people to get involved!  Take a look at some of the current Feature Request Issues, and let us know if you can help.

- Create Docker for Tilemill releases: https://github.com/tilemill-project/tilemill/issues/2742

- Create Survey of Users: https://github.com/tilemill-project/tilemill/issues/2743

- Get Funding for Tilemill: https://github.com/tilemill-project/tilemill/issues/2744

# General Info

TileMill is a modern map design studio powered by [Node.js](https://nodejs.org) and [Mapnik](https://mapnik.org).

- TileMill is tested on Linux with Node 8.11.3 LTS, and on MacOS 10.14 with Node 8.15.0 lts/carbon

- TileMill currently only works in server mode, there is no standalone GUI.  Your browser is used for the interface.

- There are no native packages provided. Installation requires cloning this repo. See details below under *Installation*.

- Tilemill should theoretically work on the Windows platform, but it isn't tested.

# Dependencies

- Mapnik > v3.6.2 (but may work on earlier versions)

- Node.js:  (earlier Node.js versions may work, but are not tested)

	- Ubuntu: v8.11.x

	- OSX: v8.15.x lts/carbon

- Protobuf: Ubunto: these need to be installed: libprotobuf-lite and protoc

# Installation

### Quick installation instructions for OSX:

    git clone https://github.com/tilemill-project/tilemill.git

    cd tilemill

    nvm install lts/carbon

    nvm use v8.15.0

    npm install

    npm start

### Installation Scripts 

Scripts have been created that will do most everything for you. They were written for MacOS, but may still be usable for Ubunto and Windows with some modification.  (If you are successful with Ubunto and Windows, please post an Issue to let us know!)

[Installation Script Instructions](https://tilemill-project.github.io/tilemill/docs/mac-install/)

[Full Installation instructions can be found in the TileMill Documentation](https://tilemill-project.github.io/tilemill/docs/install/).

### Docker

It is also possible to run tilemill as a docker container:

    git clone https://github.com/tilemill-project/tilemill.git

    cd tilemill

    docker-compose up

    

This will host a docker container which uses the port 20008 and 20009 for tilemill, tilemill is then reachable under [http://localhost:20009](http://localhost:20009) .

Additionally, a postgis instance is started as well which is reachable under 

	host=localhost port=5432 user=docker password=docker dbname=gis

Docker hosted volumes are used for the containers, hence if you want to use sqlite dbs you have to interact with those to get the dbs into the docker container.

    

# Build Status, Running Tests, Updating Documentation

See CONTRIBUTING.md