Analytics Map

Installation

No MCP yet? Connect your agent.

Adapting the analytics dashboard

The page combines a blank MapLibre canvas, Natural Earth country GeoJSON, visitor markers, an overview card, and Recharts breakdown cards. Replace the sample rows and locations in data.ts with the application's analytics data.

The world boundaries load in the browser from the pinned Natural Earth dataset on jsDelivr. Host that GeoJSON yourself if external runtime data is not acceptable. Because the map uses blank, this block does not request mapcn's default CARTO basemap tiles.

Agent guide

Configure map tiles and the MapLibre workerWhen: Before production, especially for commercial use, a strict Content Security Policy, or a self-hosted worker.From the collection

Configure map tiles and the MapLibre worker

mapcn's source code is MIT licensed. Its default light and dark styles request CARTO basemaps, which have separate provider terms. Upstream states that commercial use of those basemaps requires a CARTO Enterprise license. Review the provider's current terms before production use. Do not treat the component's MIT license as a tile license.

To use another provider, pass MapLibre-compatible style URLs or style objects through the styles prop. The explicit styles override blank. Use blank when the design only needs your own GeoJSON, arcs, markers, clusters, or custom layers. That creates a transparent style with no basemap tile requests.

The component configures MapLibre GL 6's module worker at runtime with MapLibreGL.setWorkerUrl, using the installed MapLibre version in an unpkg URL. Under a strict Content Security Policy, allow the actual worker and basemap origins. Upstream's minimum worker policy is:

script-src 'self' https://unpkg.com;
worker-src 'self' blob:;

To remove the unpkg runtime dependency, copy both adjacent MapLibre modules into the app's public directory:

node_modules/maplibre-gl/dist/maplibre-gl-worker.mjs
node_modules/maplibre-gl/dist/maplibre-gl-shared.mjs

Then replace the component's default worker URL with:

MapLibreGL.setWorkerUrl("/maplibre-gl-worker.mjs");

Keep the shared module beside the worker module. Add the chosen style and tile origins to the application's CSP as required by that provider.

Related items

Requires

  • Map

    A composable MapLibre map with theme-aware styles, markers, popups, controls, routes, arcs, GeoJSON layers, and point clustering.

    ReactTailwind