Troubleshooting

Map shows grey strips after opening/closing a panel

This should resolve automatically — the panel fires a map resize event after its animation completes. If you still see grey strips, zoom in or out slightly to force a re-render.

Geocoding is slow or fails

pitchmappr uses Nominatim by default, which has a hard rate limit of 1 request per second and a community-observed soft cap of about 2,500 requests per day.

If geocoding fails or seems stuck:

• Check your internet connection
• Wait a few seconds and try again (Nominatim may be temporarily overloaded)
• For bulk imports, make sure you haven't exceeded the 200-name geocoded limit
• Include lat/lon in your CSV to bypass geocoding entirely

Export is blurry at low zoom

At very low zoom levels (z2–z4, showing the whole world), even Hi-Res PNG may appear softer because the vector tiles have less detail at global scale. For sharper results, zoom in closer to your area of interest or use Focus Mode.

Focus Mode boundaries look jagged

Enable High resolution boundaries in the Focus Theme section. This loads a more detailed boundary dataset (Natural Earth 50m or 10m) that produces smoother edges at higher zoom levels.

Fonts don't load (offline use)

DM Sans and IBM Plex Mono are loaded from Google Fonts. If you're offline, the browser falls back to system fonts. This affects appearance but not functionality.

I closed the tab without saving

There is no recovery mechanism. All state is held in browser memory only. Make a habit of clicking Export JSON frequently, especially after major changes.

Markers disappear after switching themes

Switching base map themes rebuilds the map style, which can briefly cause markers to flicker. They should reappear within a second. If they don't, open the Data panel and click View all to reset the map bounds.

CSV import skips rows unexpectedly

Check the preview table in the import modal. Rows are skipped when:

• The name column is empty
• lat or lon values are present but outside valid ranges (lat: -90 to 90, lon: -180 to 180)
• The row is malformed (mismatched column count)

The preview highlights skipped rows and shows the reason.

Focus Mode doesn't activate for a country

Make sure you're in Focus Mode (not Regular Mode) via the toggle at the top of the Map panel. If the country dropdown appears greyed out, switch the mode toggle first.

Hi-Res export takes a very long time

Hi-Res PNG re-renders the entire map at 2–4× resolution from vector tiles. On slower connections, tile loading can take 5–10 seconds. The export waits for all tiles to finish before capturing. If it seems stuck, check your network connection.

Project JSON won't load

The file may be from an older schema version. pitchmappr supports automatic migration from v3 → v4. If the file uses an unrecognized schema or is corrupted, the load will fail with a toast error. Make sure you're loading a .json file that was exported from pitchmappr (not a generic JSON file).