{"id":18739549,"url":"https://github.com/springmeyer/vtiles-jamming-econo","last_synced_at":"2025-11-19T13:30:17.136Z","repository":{"id":16053054,"uuid":"18797130","full_name":"springmeyer/vtiles-jamming-econo","owner":"springmeyer","description":null,"archived":false,"fork":false,"pushed_at":"2014-04-15T11:24:50.000Z","size":180,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-28T18:28:05.420Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/springmeyer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-15T11:08:55.000Z","updated_at":"2019-08-13T15:39:44.000Z","dependencies_parsed_at":"2022-08-25T14:41:24.900Z","dependency_job_id":null,"html_url":"https://github.com/springmeyer/vtiles-jamming-econo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/springmeyer%2Fvtiles-jamming-econo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/springmeyer%2Fvtiles-jamming-econo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/springmeyer%2Fvtiles-jamming-econo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/springmeyer%2Fvtiles-jamming-econo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/springmeyer","download_url":"https://codeload.github.com/springmeyer/vtiles-jamming-econo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239619570,"owners_count":19669447,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T15:36:20.463Z","updated_at":"2025-11-19T13:30:17.052Z","avatar_url":"https://github.com/springmeyer.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# vector tiles jamming econo\n\nThis tutorial seeks to demonstrate concepts and best practices for creating vector tiles locally and making things with them at [low cost](http://en.wikipedia.org/wiki/We_Jam_Econo) and without depending on online services when a local or hands-on scriptable method readily exists.\n\nThis tutorial uses OSM coastlines since they are simple and foundational OSM data. This is a sandbox for ideas that should blossom into formal Mapbox tutorials in due time.\n\n## Depends\n\n - Node.js v0.10.x\n - TileMill 2 - `npm install` from `master` branch of https://github.com/mapbox/tm2\n - Tessera - `npm install tessera -g`\n - `unzip` command (`apt-get install unzip`)\n - Water polygons from http://openstreetmapdata.com/data/water-polygons\n\n## Setup\n\n    git clone https://github.com/mapbox/tm2\n    cd tm2\n    npm install\n    cd ../\n    git clone https://github.com/springmeyer/vtiles-jamming-econo\n    cd vtiles-jamming-econo\n    wget http://data.openstreetmapdata.com/water-polygons-split-3857.zip\n    unzip water-polygons-split-3857.zip\n\n## The Flow\n\nWe assume you've taken the time to understand TM2 concepts of a \"source\" and \"style\". This project contains two pre-created TM2 projects of these two types that both reference `water-polygons-split-3857/water_polygons.shp`:\n\n  - source.tm2: describes a source of VT to be created from `water_polygons.shp`.\n  - styles.tm2: describes a source of image tiles that visually render the data using the `source.tm2` source of vector tiles.\n\n### Setup\n\nOpen `source.tm2/data.yml` and edit `/Users/dane/projects/water-polygons/water-polygons-split-3857/water_polygons.shp` and change it to an absolute path that matches your location.\n\nOpen `style.tm2/project.yml` and edit `tmsource:///Users/dane/projects/water-polygons/source.tm2` and change it to an absolute path that matches your location.\n\nTODO: support relative paths in TM2 to avoid this problem?\n\n### Render a set Vector Tiles into a mbtiles file\n\nFrom the `vtiles-jamming-econo` directory (assuming `../tm2` checkout exists):\n\n    XML_SOURCE=/Users/dane/projects/water-polygons/source.tm2/data.xml\n    MBTILES_SINK=/Users/dane/projects/water-polygons/export.mbtiles\n\n    ../tm2/node_modules/tilelive/bin/copy \\\n    bridge://${XML_SOURCE} \\\n    mbtiles://${MBTILES_SINK} \\\n    --minzoom=0 \\\n    --maxzoom=2 \\\n    --bbox=-180,-60,180,60\n\n### Render a set image tiles into an mbtiles from the vector tiles in mbtiles\n\nTODO: not yet possible / need to finish this section\n\nMBTILES_SOURCE=/Users/dane/projects/water-polygons/export.mbtiles\n\n./node_modules/tilelive/bin/copy \\\nmbtiles://${MBTILES_SOURCE} \\\nvector://TODO \\\n--minzoom=0 \\\n--maxzoom=2 \\\n--bbox=-180,-60,180,60\n\n### Use Tessera\n\nTODO:\n\n```\none server:\n  - tessera mbtiles://./export.mbtiles\n  - or cd source.tm2 \u0026\u0026 tessera tmsource://./\nother:\n  - edit style.tm2/project.yml # change source to source: \"tilejson+http://localhost:8080/index.json\"\n  - cd style.tm2 \u0026\u0026 PORT=8081 tessera\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspringmeyer%2Fvtiles-jamming-econo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspringmeyer%2Fvtiles-jamming-econo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspringmeyer%2Fvtiles-jamming-econo/lists"}