Skip to content

urbica/tessella

Repository files navigation

tessella

npm version npm downloads build status docker pulls

tessella is a lightweight Node.js Mapbox Vector Tiles server. Inspired by tessera.

Installation

tessella requires node v7.6.0 or higher for ES2015 and async function support.

npm install tessella -g
npm install -g <tilelive modules...>

...or build from source

git clone https://github.com/urbica/tessella.git
cd tessella
npm i

Usage

Usage: tessella [options] [URI]

where [uri] is tilelive URI to serve and [options] is any of:
  --port - port to run on (default: 4000)
  --socket - use Unix socket instead of port
  --cacheSize - cache size in MB (default: 10)
  --sourceCacheSize - source cache size in # of sources (default: 6)
  --version - returns running version then exits

Examples

MBTiles

npm install -g @mapbox/mbtiles
tessella mbtiles://./whatever.mbtiles

PostGIS

npm install -g tilelive-postgis
tessella postgis://localhost/test?table=tableName&geometry_field=geom

Using with Leaflet

const map = L.map("map").setView([0, 0], 0);
L.tileLayer("http://localhost:4000/{z}/{x}/{y}.png").addTo(map);

with retina support:

const map = L.map("map").setView([0, 0], 0);
L.tileLayer("http://localhost:4000/{z}/{x}/{y}{r}.png").addTo(map, {
  detectRetina: true
});

Using with Docker

docker run -d -p 4000:4000 <URI>

Where URI is is tilelive URI to serve.