# Introduction

The SVG Map Editor is a browser-based tool for creating annotated, colour-coded maps of countries (or other SVG geometries) for inclusion in reports and documentation. Its core workflow: load an SVG map, click individual regions to assign them a colour and a text label, give each colour a defined meaning that drives an automatic legend, add a title, and export the finished graphic as a PNG or JPG at a chosen pixel size.

##### Key capabilities.

<table border="1" id="bkmrk-area-what-it-does-sv" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 28.7381%;"></col><col style="width: 71.3572%;"></col></colgroup><tbody><tr><td>Area</td><td>What it does</td></tr><tr><td>SVG ingest</td><td>Upload an SVG, or load one automatically from the `files/` folder via `?file=` URL parameter or `settings.json` default</td></tr><tr><td>Object colouring &amp; labelling</td><td>Click any shape (or its group/class) to set an inline fill colour and per-object label text; groups spanning multiple islands/paths are treated as one unit</td></tr><tr><td>Legend </td><td>Each colour gets a "meaning" in the right panel; a legend card (swatch + meaning) is rendered on the graphic in a chosen corner, plus a sidebar legend; both appear in exports</td></tr><tr><td>Title </td><td>Configurable title text, corner placement (4 options), and size (S/M/L), rendered on the map and included in exports</td></tr><tr><td>Export </td><td>PNG or JPG at specified width/height (up to 16384 px), via canvas rendering with the Inter font embedded</td></tr><tr><td>Persistence </td><td>Download/upload a versioned JSON settings file mapping element IDs to colours/labels, enabling round-trip reuse and sharing of map configurations</td></tr><tr><td>View </td><td>Zoom (10–1000%) with fit-to-screen, pan via scrollbars, keyboard shortcuts</td></tr></tbody></table>

##### Technology. 

Pure HTML/CSS/JavaScript with no build step — Tailwind CSS (Play CDN) for styling and SVG.js v3 for live SVG DOM manipulation. Configuration lives in `settings.json` (title, description, default file, help link). Any static HTTP server is sufficient to run it.

#####   
Target use case.

Rapid production of specialised country maps with consistent colour legends for internal reports and client documents — replacing manual graphic work in Illustrator/Photoshop with a repeatable, JSON-driven workflow.

\---