Get started

Embedded Studio

Embedded Studio

The Mountaya map editor inside your own product. Your users draw, edit and publish itineraries and zones without leaving your app.

import { Mountaya } from "@mountaya/client/browser";
import { MountayaStudio, MountayaStudioHost } from "@mountaya/studio-react";

const client = new Mountaya({ credential: { publishableKey, sessionToken } });

<MountayaStudioHost client={client} itineraryId={itineraryId}>
  <MountayaStudio />
</MountayaStudioHost>;

The quickstart builds this in a Vite app, with the server route the token comes from.

Before you start

  1. An agreement that includes Map Studio, the Tile API and the Data API.
  2. A publishable key (pk_…) with the studio-embedded scope, from Organization → API keys in the Mountaya app. It carries tiles and data too.
  3. A session token for the member who edits. Your server mints it with surface: "studio-embedded" and the member's user_id.
  4. Your domain in the allowed list, under Organization → Security. Mountaya keeps that list: tell us each host, localhost:5173 included.

Choose how to assemble it

PathYou mountPick it when
Host (recommended)MountayaStudioHost and MountayaStudioYou want the whole editor, themed with your colors and words.
HeadlessMountayaStudioProvider, createStudioToolBus and the hooksYou draw every control with your own design system.
Tool bus (advanced)No component: you dispatch verbs on a busYou drive the studio's verbs from a test, a server, or code of your own.

All three run the same rules. A click, your own code and the co-pilot all change the studio by dispatching a verb on one tool bus.

What it includes

The editor covers drawing and routing itineraries, waypoints, zones, collections and share links. Live collaboration, the AI co-pilot and video export are opt-in. What each member sees follows your agreement and their role.

The demo above wears the brand of a made-up outfitter: every color, corner and typeface is a --mtya-* token. It holds a demo key only, so nothing persists.

Next steps

Last updated