Export workflow: style → save view → export → PowerPoint
Export Tab
The Export tab is where your work becomes output. This is the final step in the pitchmappr workflow: you've added locations, styled the map, and saved views. Now you export images and files that can be dropped into presentations, documents, or design tools.
The tab offers four export methods: Quick Export (immediate screenshot of the current view), Export Views (batch export from saved views with precise crop framing), Change Projection (d3-geo reprojection for non-Mercator map styles), and JSON (project file save/load).
Quick Export
Quick Export captures whatever is currently visible on your map and downloads it immediately. It does not use saved views or crop ratios — it exports the full visible canvas.
| Feature | Control | Description |
|---|---|---|
| Transparent background | Checkbox | When enabled, exports PNG and SVG files with a transparent background (alpha channel) instead of the map's earth/background color. This is critical for presentation workflows where your map image needs to sit on a colored or textured slide background. With transparency enabled, the exported PNG has no background fill, so whatever is behind it in your slide shows through. Default is OFF. Affects both Quick Export and Export Views. |
| PNG | Button | Exports the current map view as a standard-resolution PNG image. The image captures exactly what's visible on screen, including all visible markers, labels, and map features at the current zoom and center position. The file downloads immediately. The filename uses your Job Number (if set) or Project Name. Standard resolution matches your screen's display density, which is fine for on-screen presentations but may appear pixelated when printed or displayed at large sizes. |
| PNG Hi-Res | Button | Exports the current map view as a high-resolution PNG at 2–5x the standard scale (the exact multiplier is determined automatically based on your GPU capabilities). This creates a much larger, sharper image by re-rendering the map in an offscreen container at higher pixel density. The result is crisp enough for print materials, large-format displays, and high-DPI screens. Takes 2–5 seconds to render due to the larger canvas size. Use this for any output that will be printed or displayed larger than a laptop screen. |
| SVG | Button | Exports the current view as a vector SVG file. Only available in Focus Mode. SVG exports include vector-rendered map features (boundaries, markers, labels) that scale infinitely without quality loss. The output is an SVG file that can be opened and edited in Adobe Illustrator, Figma, Inkscape, or any vector graphics editor. Ideal for further design work, print production, or any situation where resolution independence is needed. |
Export Views
Export Views produces precisely framed images from your saved views. Unlike Quick Export, these outputs are cropped to the exact aspect ratio defined by each view, producing consistent, repeatable results every time.
| Feature | Control | Description |
|---|---|---|
| Transparent background | Checkbox | Shared with Quick Export (same checkbox, same effect). Controls background transparency for all view-based exports. |
| Per-view PNG | Button | Exports a saved view as a cropped PNG image at the view's saved zoom, center, and crop ratio. The image is precisely framed according to the view's aspect ratio, producing output that matches the crop preview overlay exactly. This means every export of the same view produces identical framing. |
| Per-view Hi-Res PNG | Button | Same as per-view PNG but at 2–5x higher pixel density. Produces a larger, sharper image suitable for print. Same precision framing as standard PNG. |
| Per-view SVG | Button | Exports a saved view as a cropped SVG. Only available for views that were saved in Focus Mode. Produces vector output with the view's exact crop framing. |
Change Projection
The d3-geo projection system renders maps using cartographic projections other than the standard Mercator (which is what the interactive MapLibre map uses). Projections like Albers Equal Area distort shapes to preserve area accuracy, making them standard in US government maps and many finance presentations.
This system is completely independent from the MapLibre base map. It renders a separate map using D3's projection algorithms with its own geometry (from Natural Earth data), styling, and export pipeline. A small preview canvas in the sidebar shows what the projection output will look like.
| Feature | Control | Description |
|---|---|---|
| Enable | Checkbox (master) | Master toggle for the entire projection export system. When enabled, all projection configuration controls appear below. When disabled, the projection system is dormant and has no effect on the rest of the application. |
| Projection | Dropdown | Selects the cartographic projection algorithm. Each projection has different mathematical properties for how it represents the 3D earth on a 2D surface. Options include: Albers USA (the standard US map projection with built-in Alaska/Hawaii insets — the most common choice for US-focused maps), Albers (conic equal-area, good for mid-latitude countries), Conic Equal Area, Lambert Conformal (preserves angles, used in aviation charts), Equirectangular (simple plate carrée, no distortion at equator), Natural Earth (rounded world view with balanced distortion), Mercator (standard web map projection), Equal Earth (modern equal-area world projection), and Orthographic (globe/sphere view). |
| Region preset | Dropdown | Selects a pre-configured center point and scale for common geographic regions: CONUS (contiguous US), North America, Europe, Asia, World. Selecting a preset automatically fills in the center longitude, latitude, and scale values below. Select Custom to set values manually. Presets save time by providing good starting parameters for common map regions. |
| Center longitude | Slider (-180 to 180) | Sets the center meridian (east-west position) of the projection. The map is centered on this longitude. Adjusting this automatically switches the region preset to "Custom". For US maps, -96 is typical; for Europe, around 10; for Asia, around 100. |
| Center latitude | Slider (-90 to 90) | Sets the center parallel (north-south position) of the projection. Works with longitude to define the projection's focal point. For US maps, 38 is typical; for Europe, around 50; for global maps, 0 (the equator). |
| Scale | Slider (50–3000) | Controls the zoom/magnification of the projection. Higher values zoom in closer to the center point; lower values show more area. The appropriate scale depends heavily on the projection type and the geographic region you're showing. |
| Fit to markers | Button | Automatically computes the optimal center longitude, latitude, and scale to fit all your marker locations into the projection view with appropriate padding. Uses the bounding box of all locations to calculate the best parameters. This is the quickest way to get a good starting view that includes all your data. |
| Land color | Color picker | Sets the fill color for all land masses in the projection export. Default is light grey (#F0F0F0). This is independent from the base map's earth color — the projection system renders its own geometry. |
| Border color | Color picker | Sets the stroke color for country border lines in the projection. Default is medium grey (#AAAAAA). |
| State color | Color picker | Sets the fill color for US state polygons (when state borders are enabled). Default is light grey (#CCCCCC). Provides visual distinction between states. |
| Water color | Color picker | Sets the fill color for water features (oceans, lakes) in the projection. Default is white (#FFFFFF). Setting this to a blue creates a more traditional cartographic look. |
| State borders | Checkbox | Toggles US state boundary lines in the projection export. Default is ON. State borders help identify which state each marker is in. Disable for cleaner international maps where US states aren't relevant. |
| Country borders | Checkbox | Toggles international country boundary lines. Default is ON. Essential for geographic context in most maps. |
| State labels | Checkbox | Toggles US state abbreviation labels (e.g. "NY", "CA") placed at each state's geographic centroid. Default is OFF. Adds text labels to help viewers identify states without needing to recognize their shapes. Only renders for US states. |
| Border width | Slider (0.1–3.0) | Controls the stroke width of all boundary lines (both country and state borders). Default is 0.5. Higher values create more prominent borders; lower values create subtle, thin lines. |
| Output size | Dropdown | Selects the pixel dimensions for the exported projection image. Options: 1920x1080 (Full HD 16:9), 2560x1440 (QHD 16:9), 3840x2160 (4K 16:9), 1280x960 (Standard 4:3), 1920x1440 (HD 4:3). Larger sizes provide more detail and sharper output but create bigger files. 1920x1080 is sufficient for most presentation slides. |
| Export PNG | Button | Renders and downloads the projection map as a PNG image at the selected output size. Your location markers and labels are rendered on top of the D3 projection geometry. Background is transparent by default. |
| Export SVG | Button | Renders and downloads the projection map as a vector SVG file. All geometry (land, boundaries, markers, labels) is exported as scalable vector paths that can be edited in Illustrator or Figma. Ideal for print production or design workflows. |
JSON
The JSON section handles your project's save file. pitchmappr projects are stored as .json files that contain everything needed to reconstruct the project: all settings, datasets, locations, saved views, theme selections, and Focus Mode configuration.
| Feature | Control | Description |
|---|---|---|
| Export JSON | Button | Downloads the entire project as a .json file. This is your project's save file — it contains the complete project state and can be re-imported later to restore everything exactly as it was. The filename uses your Job Number or Project Name. You should export JSON regularly to avoid losing work, especially before closing the browser. The "Unsaved" badge in the header bar reminds you when changes haven't been exported. |
| Import JSON | Button → file picker modal | Opens a file picker to upload a previously exported .json project file. Importing restores the entire project state — all locations, datasets, views, settings, and theme selections are replaced with the file's contents. The current project is completely overwritten, so make sure you've exported any unsaved work before importing. A confirmation dialog appears before the import proceeds. |