System Constants
These are the fixed limits, ratios, and rendering parameters built into pitchmappr. They're not user-configurable but are documented here for reference and to explain the boundaries you may encounter while using the tool.
Limits
| Constant | Value | Description |
|---|---|---|
CFG.maxLocations | 1000 | Maximum total rows in a project — locations already on the map plus rows still waiting to be geocoded or placed. The limit prevents performance problems (rendering, geocoding, exporting) with very large marker counts. It's checked as you paste or import, and you're told when rows don't fit — nothing is ever silently dropped. If you need more than 1000, split your data across projects. |
CFG.maxImportNames | 200 | Maximum lines per paste in the "Paste a list…" box, to keep a single paste manageable. CSV import has no per-file limit — it's bounded by the 1000-row total above. CSV rows with latitude/longitude columns skip geocoding entirely (they're placed as-is when you press Geocode locations). |
| Min datasets | 1 | At least one dataset must always exist in a project. Removing the last dataset is refused. Removing a dataset that still holds locations asks whether to delete them or move them to a dataset you pick. |
| HQ model | dataset | Headquarters status comes from dataset membership: every location in a dataset named HQ (or Headquarters) renders as an HQ marker, and a project can have as many HQ locations as that dataset holds. Older projects that used the previous single-HQ flag are converted automatically on first open. |
Crop Ratios
These are the available aspect ratios for saved views and export framing. Each ratio determines the shape of the export crop frame.
| ID | Name | Aspect | Description |
|---|---|---|---|
16x9 | 16:9 | 1.78:1 | Standard widescreen aspect ratio. Matches PowerPoint (widescreen), Keynote, Google Slides, and most modern presentation templates. The most commonly used export format for business presentations. |
4x3 | 4:3 | 1.33:1 | Standard (legacy) slide format. Used by older presentation templates and some print layouts. Also matches many traditional document insert dimensions. |
3x2 | 3:2 | 1.5:1 | Photo and film format — the classic 35mm frame. Use this when the map has to fill an image placeholder that was sized for a photograph, which is common in deck templates and report layouts that already have a picture box. Slightly narrower than 16:9, so it keeps more vertical map area. |
1x1 | 1:1 | 1:1 | Square format. Useful for social media posts, profile images, balanced compositions, and situations where the output needs to be symmetrical. |
2x1 | 2:1 | 2:1 | Ultra-wide banner format — twice as wide as it is tall. Use this for a strip across the top of a slide or report page, and for geography that runs east-west (a coastline, a rail corridor, the continental US) where the extra width earns its space and the tighter vertical crop costs you nothing. |
letter | Letter | 1.29:1 | US Letter landscape (11" x 8.5"). Matches standard North American print paper in landscape orientation. Use this when your export will be printed on standard paper or inserted into a letter-format document. |
a4 | A4 | 1.41:1 | A4 landscape (297mm x 210mm). Matches standard international print paper in landscape orientation. Use this for maps destined for non-US print output. |
Marker Rendering
These parameters control how markers are rendered on screen and in exports. They're not directly configurable but explain the base values that the user-accessible size multipliers act upon.
| Property | Value | Description |
|---|---|---|
| Base radius (live) | 9px | On-screen marker radius before any scaling is applied. This is the base size that markerScale multiplies. At the default 1.0x scale, markers are 9px radius on screen. |
| Base radius (export) | 11px | Export marker radius before scaling. Slightly larger than the screen radius to ensure markers remain visible and proportional in printed output and high-resolution exports. |
| Halo ring width | 22% (circle), 18% (square), 15% (star) of radius | White ring width around each marker. Each shape uses a different proportion of the marker radius so all three rings read at the same visual weight. The dataset's Halo slider (0–5) multiplies these base proportions at halo × 2/3 — the default halo of 1.5 gives the classic 1.0x ring, and halo 0 removes both the ring and the label glow. |
| Shapes | circle, square, star | The three available marker shapes. Circle is a filled circle, square is an upright square with rounded corners, star is a 5-pointed star. All are rendered as SVG paths for sharp rendering at any size. |
| Shield base text-size | 8px | Default text size for highway shield route numbers. Multiplied by the shield text size setting. |
| Shield base icon-size | 0.8 | Default icon scale for shield badge graphics. Multiplied by the shield icon size setting. |
Base Flavor Map
This table maps pitchmappr's internal theme keys to the underlying Protomaps flavor names. It's primarily relevant for theme developers and for understanding how the theme system works internally.
| UI Key | Protomaps Flavor | Label | Description |
|---|---|---|---|
voyager | light | Light — warm, detailed | Full-color warm palette with terrain detail. The default and most feature-rich flavor. |
positron | white | White — clean, minimal | Bright white base optimized for data visualization. Minimal visual weight. |
light | grayscale | Grayscale — neutral | Monochrome grey palette. Neutral, non-distracting background for data-focused maps. |
dark | dark | Dark | Inverted dark palette for dark-themed presentations. Light roads and labels on dark background. |
black | black | Black — high contrast | Very dark data-viz palette (earth #141414). Maximum contrast for dramatic presentations. |