C3B2W23andClaude Fable 5.1 8f169f1ecc Add runtime CARTO_API_KEY for basemap tiles ...

CARTO now requires an API key for its basemap tiles; without one every
tile in the DEFAULT dark/light map carries an "API KEY REQUIRED"
watermark. The tile URLs were hardcoded in mapStyles.ts with no way to
supply a key, and because the frontend ships as a prebuilt image a
NEXT_PUBLIC_ variable would be baked in empty for every Docker user.

- New frontend-local route GET /api/basemap-config reads CARTO_API_KEY
  from the frontend container's environment at request time (same
  pattern as BACKEND_URL), so no image rebuild is needed.
- useBasemapConfig() fetches it once per page load; MaplibreViewer
  builds the MapLibre style from it via buildBasemapStyle(theme, key)
  and defers the map's first style load until the config has settled,
  avoiding a burst of unkeyed tile requests followed by a style swap.
- Tile URLs move to CARTO's documented rastertiles/ path with ?key=
  appended when configured. Unkeyed URLs serve byte-identical tiles to
  the old path, so deployments without a key behave exactly as before.
- CARTO_API_KEY wired through docker-compose.yml and documented in
  .env.example, README (data source table + frontend env table) and
  docs/OUTBOUND_DATA.md.
- Tests cover the route (unset / set / trimmed) and the style builder.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

2026-09-13 14:54:01 -07:00

..

mesh

release: prepare v0.9.7

2026-05-01 22:56:50 -06:00

APRS_IS.md

docs(aprs): document responsible APRS-IS configuration

2026-08-23 06:54:58 -06:00

contributor-map.md

Add contributor map and align backend version

2026-07-03 13:26:36 +04:00

LIVEUAMAP.md

fix(liveuamap): make enrichment resilient and non-blocking

2026-08-18 15:52:46 -06:00

OUTBOUND_DATA.md

Add runtime CARTO_API_KEY for basemap tiles

2026-09-13 14:54:01 -07:00

production-hardening.md

Track production-hardening checklist in docs (gitignore exception).

2026-06-06 20:23:11 -06:00