An open API service indexing awesome lists of open source software.

https://github.com/spider-hand/vector-tile-lab

An interactive sandbox to tune vector tiles
https://github.com/spider-hand/vector-tile-lab

data-visualization developer-tools geojson maplibre openstreetmap pmtiles vector-tiles

Last synced: 3 months ago
JSON representation

An interactive sandbox to tune vector tiles

Awesome Lists containing this project

README

          

# vector-tile-lab

![demo](https://github.com/user-attachments/assets/7d09b3f4-4da0-4ecd-8a4b-8f495f709938)

[![Docker Build](https://github.com/spider-hand/vector-tile-lab/actions/workflows/docker-build.yml/badge.svg)](https://github.com/spider-hand/vector-tile-lab/actions/workflows/docker-build.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

Vector Tile Lab is a local development tool for experimenting with your vector tiles. It lets you convert GeoJSON into vector tiles, tweak Tippecanoe parameters and visualize data through interactive UI.

## Features
- Zero config - Launch with a single command, no manual setup required
- Instant iteration - Adjust tile generation parameters and test outputs immediately
- Visual insights - Compare tilesets through interactive charts and performance metrics

## Quick Start

### Prerequisite

- [Docker](https://www.docker.com/)

1. Clone this repository:

```sh
git clone https://github.com/spider-hand/vector-tile-lab.git
cd vector-tile-lab
```

2. Set up environment variables:

```sh
cp .env.example .env
cp server/.env.example server/.env
cp client/.env.example client/.env
```

Change the values if needed.

3. Build and start the services:

```sh
docker-compose up --build -d
```

## Contributing
- Bug fix PRs are always welcome.
- UI changes or new features should not be submitted without prior discussion. Please open an issue first to propose and discuss them.

Thanks for your understanding and contributions.

## License
[MIT](./LICENSE)