{"id":13553411,"url":"https://github.com/digidem/mapeo-settings-builder","last_synced_at":"2025-08-08T12:12:01.522Z","repository":{"id":10150249,"uuid":"64653736","full_name":"digidem/mapeo-settings-builder","owner":"digidem","description":"Build presets and sprites for the Mapeo apps","archived":false,"fork":false,"pushed_at":"2025-04-08T18:04:00.000Z","size":699,"stargazers_count":3,"open_issues_count":25,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T13:13:44.398Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/digidem.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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":"2016-08-01T09:23:12.000Z","updated_at":"2024-09-17T15:52:19.000Z","dependencies_parsed_at":"2024-03-07T20:29:24.410Z","dependency_job_id":"8970398b-49f0-4565-97b1-33c52237075b","html_url":"https://github.com/digidem/mapeo-settings-builder","commit_stats":{"total_commits":100,"total_committers":7,"mean_commits":"14.285714285714286","dds":"0.18000000000000005","last_synced_commit":"37754759c91b777b40a092a81bcbe0aaa754f911"},"previous_names":["digidem/mapeo-presets-builder"],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digidem%2Fmapeo-settings-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digidem%2Fmapeo-settings-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digidem%2Fmapeo-settings-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digidem%2Fmapeo-settings-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digidem","download_url":"https://codeload.github.com/digidem/mapeo-settings-builder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252088344,"owners_count":21692779,"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-08-01T12:02:24.123Z","updated_at":"2025-05-02T18:31:09.202Z","avatar_url":"https://github.com/digidem.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","others"],"sub_categories":[],"readme":"# Mapeo Settings Builder\n\n[![npm version][1]][2]\n[![js-standard-style][3]][4]\n\n[1]: https://img.shields.io/npm/v/mapeo-settings-builder.svg\n[2]: https://www.npmjs.com/package/mapeo-settings-builder\n[3]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg\n[4]: http://standardjs.com/\n\n\u003e Build settings file for [Mapeo Desktop](https://github.com/digidem/mapeo-desktop)\n\nWhen run in a folder of configuration, icon files and imagery definitions will create a single settings tarball which can be imported into [Mapeo Desktop](https://github.com/digidem/mapeo-desktop) to configure the application for a particular use-case.\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contribute](#contribute)\n- [License](#license)\n\n## Install\n\n```\nnpm install --global mapeo-settings-builder\n```\n\n## Usage\n\n```sh\n# Lint settings\nmapeo-settings lint\n\n# Build settings tar file and output to stdout\nmapeo-settings build {OPTIONS}\n\n# Generate a project key\nmapeo-settings generate-key\n```\n\nMapeo Presets Builder expects the following file structure in the current directory:\n\n```\n├── categories\n│   ├── a_category.json\n│   ├── other_category.json\n│   └── ...\n├── fields\n│   ├── a_field.json\n│   ├── other_field.json\n│   └── ...\n├── presets\n│   ├── preset_category\n│   │   ├── a_preset.json\n│   │   ├── other_preset.json\n│   │   └── ...\n│   ├── other_preset_category\n│   │   ├── a_preset.json\n│   │   ├── other_preset.json\n│   │   └── ...\n│   ├── uncategorized_preset.json\n│   ├── other_uncategorized_preset.json\n│   └── ...\n├── icons\n│   ├── a_icon.svg\n│   ├── other_icon.svg\n│   └── ...\n├── defaults.json\n├── imagery.json\n├── metadata.json\n└── style.css\n```\n\nWhere:\n\n- `imagery.json` is an object that should follow the structure defined by [editor-layer-index](https://github.com/osmlab/editor-layer-index/blob/gh-pages/schema.json)\n- `style.css` is custom css to override iD css.\n- `icons` is a folder of svg images to build a sprite for preset icons\n- `categories`, `fields`, `presets`, `defaults.json` see [iD presets](https://github.com/openstreetmap/iD/tree/master/data/presets)\n- `metadata.json` contains optional properties:\n  - `projectKey` is a 32 byte (256-bit) random number encoded as a `hex` string (numbers 0-9 and lowercase letters a-f)\n  - `name` is a human-readable name of these presets (written from `package.json` if it does not already exist)\n  - `version` is the version number of the presets (written from `package.json` if it does not already exist)\n  - `syncServer` is the URL of a mapeo-web server to sync to. (written from `package.json` if it does not already exist). For the Digital Democracy server this should be `wss://cloud.mapeo.app`, but the project key will need to be enabled on the server first.\n\n### Options\n\n- `-l, --lang=\u003clangCode\u003e` - the base language of the settings, defaults to `en`.\n- `-o, --output=\u003cfilename\u003e` - write the settings tarball to this file, if unspecified prints to stdout.\n- `-t, --timeout=\u003cnumber\u003e` - timeout limit (in milliseconds) for icon generation process.\n\n## Contribute\n\nPRs accepted.\n\nSmall note: If editing the Readme, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.\n\n## License\n\nMIT © Digital Democracy\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigidem%2Fmapeo-settings-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigidem%2Fmapeo-settings-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigidem%2Fmapeo-settings-builder/lists"}