{"id":23336074,"url":"https://github.com/yuiseki/mbtiles2tilejson","last_synced_at":"2025-04-09T20:52:15.912Z","repository":{"id":66605861,"uuid":"458095041","full_name":"yuiseki/mbtiles2tilejson","owner":"yuiseki","description":"🗺 npm package that generate TileJSON file from MBTiles file","archived":false,"fork":false,"pushed_at":"2025-04-05T20:10:20.000Z","size":195,"stargazers_count":6,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T21:19:59.852Z","etag":null,"topics":["mbtiles","npm","npm-package","openstreetmap","tilejson"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/mbtiles2tilejson","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yuiseki.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-11T07:58:14.000Z","updated_at":"2024-11-21T00:04:14.000Z","dependencies_parsed_at":"2023-09-29T03:30:08.843Z","dependency_job_id":"b2288cb3-3142-439e-935f-0501c11082de","html_url":"https://github.com/yuiseki/mbtiles2tilejson","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/yuiseki%2Fmbtiles2tilejson","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuiseki%2Fmbtiles2tilejson/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuiseki%2Fmbtiles2tilejson/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuiseki%2Fmbtiles2tilejson/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuiseki","download_url":"https://codeload.github.com/yuiseki/mbtiles2tilejson/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111959,"owners_count":21049577,"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":["mbtiles","npm","npm-package","openstreetmap","tilejson"],"created_at":"2024-12-21T02:11:57.984Z","updated_at":"2025-04-09T20:52:15.879Z","avatar_url":"https://github.com/yuiseki.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mbtiles2tilejson\n\nThis is a npm package that generate TileJSON file from MBTiles file.\n\n## Known Limitation\n\nCurrently this npm package support TileJSON Specification 2.0 only.\n\n## Why?\n\nWhen you want to create your own vector tile web maps, TileJSON file is pretty important.  \nBecause url of TileJSON is required to create your own Mapbox style specification.\n\nNowadays, there has been an industry standard produce process for creating your own vector tile web maps.\n\n1. Get \\*.pbf of OpenStreetMap\n2. Generate \\*.pbf -\u003e \\*.mbtiles as MBTiles with OpenMapTiles schema\n3. Generate \\*.mbtiles -\u003e /z/x/y/\\*.pbf\n4. Deploy /z/x/y/\\*.pbf to server\n5. **Write TileJSON file of your vector tile server**\n6. Write Mapbox style specification file (style.json) to styling and displaying your vector tiles\n7. Write HTML/CSS/JS that load and draw the maps based on style.json\n\nIf you have a lot money, you can keep running server that can dynamically generate /z/x/y/\\*.pbf from MBTiles file.  \nThose MBTiles server also has capabilities to dynamically generate TileJSON file from MBTiles file.  \nBut if you are trying to extremely save money, you will want to serve /z/x/y/\\*.pbf files on static web server.\n\nMy findings is that there is no good tools to just generate custom TileJSON from MBTiles.\n\nI do not want to serve MBTiles.  \nI want to just generate TileJSON.\n\n(... I'm also feeling some pain with step 6, but I'd like to solve that with another tool)\n\nIf you interested to create your own vector tile web maps,  \nYou can see detail on https://scrapbox.io/yuiseki/How_to_create_your_own_vector_tile_web_maps\n\n## Install\n\nInstall as a command:\n\n```\nnpm i -g mbtiles2tilejson\n```\n\nInstall as a package:\n\n```\nnpm i mbtiles2tilejson\n```\n\n## Usage\n\nMBTiles file path and URL option are required.\n\n```\nmbtiles2tilejson path/to/region.mbtiles --url http://localhost:3000/ \u003e path/to/tiles.json\n```\n\n## Development\n\n```\nnpm ci\nnpm run build\nnpm link\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuiseki%2Fmbtiles2tilejson","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuiseki%2Fmbtiles2tilejson","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuiseki%2Fmbtiles2tilejson/lists"}