Skip to main content

Build with Kaleidr

Put living maps in your product — AI map chat, published maps, designed basemaps, and the map editor, embedded on your site with one SDK and one platform key.

QuickstartGet an API key

What do you want to build?

Attach AI to your map

Attach the Kaleidr Control Tower — chat-driven navigation, place answers, live markers — to the Mapbox, Google, or MapLibre map you already run.

Embed maps & basemaps

Drop a published Kaleidr map into any page by share id, or serve a designed Kaleidr basemap as the canvas for your own data.

Design maps in your app

Mount the Kaleidr map editor inside your product and let your users create and style maps without leaving your page.

Up and running in minutes

  1. Get a publishable key — origin-locked and safe in page source; the SDK exchanges it for a short-lived session at runtime.

  2. Add one script — kaleidr.js installs window.Kaleidr and the <kaleidr-map> element.

  3. Drop the element — pick a product (chat, viewer, editor, tile); the doorway is chosen automatically.

Full quickstart
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>

<!-- a published map, by share id -->
<kaleidr-map product="viewer" share-id="abcd1234"
             style="height:480px"></kaleidr-map>

<!-- AI chat on YOUR live map (stash it: mapEl.__kaleidrMap__ = map) -->
<kaleidr-map product="chat" map-target="#map"
             publishable-key="kld_pk_live_…"></kaleidr-map>

Explore the platform

QuickstartEmbed a Kaleidr map in two lines.Get an API keyPublishable vs server keys, and when to use each.Platform APIEndpoints, auth, quota, CORS, and the SSE wire contract.ErrorsStatus codes and error shapes across the API.ChangelogWhat changed in the SDK and platform API.CDN versioningVersion-pinned embed URLs that never break under you.

One key, one bill

A platform key carries capability scopes — ai (chat & inference), maps (viewer & tiles), design (the editor) — in two safe forms: a publishable key for the browser and a server key for your backend. Same org, same quota, one invoice.

How auth & scopes work