Get started
Reference

Components

Components

Each component's props and styling are tables on the guide that documents it. A component with no props of its own links to its guide only.

@mountaya/elements-react

ComponentSummaryDocumented on
MountayaElementsProviderMountayaElementsProvider supplies what every element reads: the map they drive, the client they resolve an id through, the glyph sets, a language, a locale, the copy, the design tokens and the paint overrides.Guide · Props
MapViewMapView owns one map's lifecycle: it builds a MountayaMap into its container once, follows the few options a mounted map can change, and destroys the map as it unmounts.Guide · Props · Styling
MapControlsThe stack's body, which MapControls publishes with its controls attached as parts.Guide · Props · Styling
ZoomControlZoomControl is the +/- pair, as one flush chip.Guide · Props · Styling
CompassControlCompassControl resets the bearing to north, and doubles as an orientation readout.Guide · Props · Styling
CompassRoseGuide · Props · Styling
GeolocateControlGeolocateControl centres the map on the device location.Guide · Props · Styling
PanelControlPanelControl is a button that owns a floating panel.Guide · Props · Styling
DirectionsControlDirectionsControl asks the application to open directions for what the map is showing.Guide · Props · Styling
DownloadControlDownloadControl asks the application to export what the map is showing.Guide · Props · Styling
SearchControlSearchControl is a search box over Mountaya's unified search, with the results under it.Guide · Props · Styling
StreetViewControlStreetViewControl is the handle a user drags onto the map to look around.Guide · Props · Styling
LayersPanelLayersPanel is the base-map and overlay picker.Guide · Props · Styling
PoiPanelPoiPanel toggles what the points-of-interest overlay draws, one concept at a time.Guide · Props · Styling
PreferencesPanelPreferencesPanel is the units and language picker.Guide · Props · Styling
ControlButtonControlButton is the square chip every map control is built from.Guide · Props · Styling
ControlGroupGuide · Props · Styling
ControlTooltipControlTooltip is the two-line label beside every map control: the control's name, then a dimmed sentence saying what it does.Guide · Props · Styling
GlyphGlyph draws one icon from the provider's control set, or from the set icons names.Guide · Props · Styling
OptionRowOptionRow is one selectable line in a panel.Guide · Props · Styling

@mountaya/elements-react/elements

ComponentSummaryDocumented on
ItineraryProfileGuide · Props · Styling
ItinerarySegmentTableItinerarySegmentTable states every leg of an itinerary, in the order it runs.Guide · Props · Styling
ItineraryWaypointTableItineraryWaypointTable states an itinerary as its PLACES, one row per place per pass.Guide · Props · Styling
WaypointCardWaypointCard states one place: what it is called, what it is, and everything it records.Guide · Props · Styling

@mountaya/elements-react/editor

ComponentSummaryDocumented on
EditorMapViewEditorMapView owns one map's lifecycle and hands out the MapClient an editor drives it through, edits included.Guide · Props · Styling
ViewerMapViewViewerMapView owns one map's lifecycle and hands out the MapClient a viewer drives it through: it draws an itinerary and the tile layers, moves the camera, answers a map query and records through a VideoSeam.Guide · Props · Styling

@mountaya/studio-react

ComponentSummaryDocumented on
StudioControlsStudioControls is Mountaya's map control stack: the buttons that sit over a map and change what it shows, in the order a reader meets them.Guide · Props · Styling
MountayaStudioHostMountayaStudioHost is the one component a consumer mounts, and it mounts everything else.Guide · Props
MountayaStudioGuide · Props · Styling
MountayaStudioViewerGuide · Props · Styling
StudioHostRegistryProviderStudioHostRegistryProvider publishes a registry to everything beneath it.Guide · Props
SegmentListSegmentListRoot renders the studio's segment editor: the chain as two-line editor rows, a hover gutter between each pair carrying the insert and merge accelerators, and the add control at the foot.Guide · Props
ReadOnlySegmentListGuide · Props
WaypointListWaypointList is the studio's waypoint editor: the saved waypoints in position order, the in-flight create draft appended while one is open, and the host's add control below.Guide · Props
EditorListSectionEditorListSection is the shared chrome around an editor's list of rows (persisted segments/waypoints and the import draft's).Guide · Props
SegmentSeamSegmentSeam is the hover gutter between two segment rows: a zero-height sibling of the rows carrying the pill that inserts a segment into this gap and the pill that merges the two rows it sits between.Guide · Props
RadioOptionCardRadioOptionCard is one option card of a mode, format or profile picker.Guide · Props
StudioToggleRowGuide · Props
PrivacyControlPrivacyControl is the one private/public control the itinerary create/edit form, the import shell, the suggest shell, the zone panel, and the embed wizard share, so each reads with the same wording and chrome.Guide · Props
LanguageSelectLanguageSelect is the language picker: a Select carrying an optional mark flush-left in its input and beside every option, with the selected row carrying the native combobox check.Guide · Props
AllowlistFieldGuide · Props
OrganizationScopeOptionRowOrganizationScopeOptionRow is one row inside a scope picker's dropdown: the glyph for the scope's kind beside its two-line identity.Guide · Props
AgentThreadsProviderAgentThreadsProvider binds the studio's concurrent chats to React.Guide · Props
FullscreenModalGuide · Props
FullscreenHeaderGuide · Props
PublicationNoticePublicationNotice tells a publisher that what sits beside it is the PUBLISHED itinerary, not the one they have been editing.Guide · Props
UnpublishedPanelGuide · Props
AppModalAppModal is the dialog shell every standard modal composes: a centred Mantine Modal whose header pairs an optional icon accent with the title and a dimmed description beneath it, whose body is a consistent stack, and whose footer is pinned below it.Guide · Props
ModalFooterModalFooter is the shared action row a dialog ends with WHEN IT HAS SOMETHING TO DO: the abandon/confirm cluster on the right and, when an explicit secondary action is supplied, that action pinned to the far left opposite it (space-between), so a destructive or utility action (Reset/Disable a link, Copy a key, Dissolve a group) reads as distinct from the primary.Guide · Props
ConfirmModalConfirmModal is the one confirm dialog the studio raises: the AppModal shell (centered + dimmed + the shared header band) whose footer is a [Cancel] [Confirm] pair.Guide · Props
StudioHeaderStudioHeader is the brand lockup a studio's own chrome carries, and the place a host replaces it through.Guide
SidenavContentHeaderSidenavContentHeader is the chrome a sidenav panel mounts at its top.Guide · Props
SidenavContentBodySidenavContentBody is a sidenav panel's body: the container a panel wraps its content in, and the middle member of the panel chrome, between SidenavContentHeader and the footer the panel pins to its bottom edge.Guide · Props
SidenavFormActionsSidenavFormActions is the bottom-pinned primary action a sidenav flow renders in its panel's footer: one full-width button carrying the flow's explicit verb, with an optional line of keyboard shortcuts above it and an optional dimmed hint beneath.Guide · Props
ErrorAlertGuide · Props
ListSkeletonListSkeleton renders a vertical stack of skeleton stripes shown while a list loads.Guide · Props
EmptyStateEmptyState is the "nothing here" block: a backgroundless gray icon over a title, an optional dimmed description, and an optional action.Guide · Props
WarningAlertGuide · Props
FormErrorAlertFormErrorAlert is the inline error a form shows directly above its actions.Guide · Props
ActivityIconActivityIcon is the activity badge a row, a header or a dialog subject leads with: the activity's silhouette in a soft tinted chip.Guide · Props
DialogSubjectDialogSubject is the identity line a dialog states under its title when it acts on one concrete named resource: the activity glyph, the name, then the distance · ↗ascent through the shared RowMetadata, the same treatment the itinerary list row and the editor's own header carry, so the resource reads here as the same object it was picked from.Guide · Props
ItineraryActionsMenuItineraryActionsMenu is the three-dots action menu for a single itinerary, shared by the sidenav row and the elevation panel.Guide · Props
ItineraryFormGuide · Props
ItinerarySubHeaderItinerarySubHeader is the band under the editor's header that answers "what does the public see?" and offers the one act that changes that answer.Guide
ItinerarySegmentListItinerarySegmentList is the studio's segment editor for the OPEN itinerary.Guide
ItineraryWaypointListItineraryWaypointList is the studio's waypoint editor for the OPEN itinerary.Guide
ItineraryProfilePanelItineraryProfilePanel is the docked elevation profile of the itinerary in view: the chart, its characteristics and its analysis, which the profile-insights entitlement gates.Guide · Props
PersistedSegmentRowPersistedSegmentRow is the stored chain's row: the published editor row, with this tree's units, copy, collaboration badges and peer-lock name resolved around it.Guide · Props
DraftSegmentRowDraftSegmentRow is the import preview's row: the same published editor row, with the draft's own metrics and one control the stored chain has no use for.Guide · Props
PresenceRosterPresenceRoster renders a compact Avatar.Group of the collaborators currently in the given resource's session.Guide · Props
PeerLockTooltipGuide · Props
LockedActionsButtonLockedActionsButton is the peer-lock specialization of DisabledActionsButton: it resolves the "{holder} is editing this…" label through the host's resolvePeerName and renders the shared disabled kebab with it, so a peer-locked row's actions trigger names WHO holds the lock.Guide · Props
ItineraryHeaderTitleItineraryHeaderTitle is the editor header's name: a heading that turns into its own rename field in place.Guide · Props
ItineraryHeaderIdentityItineraryHeaderIdentity is everything the editor's header says about the itinerary BESIDES its name, on ONE dimmed line: what it is routed for, how far it goes, and how much it climbs.Guide
ItineraryHeaderMetaItineraryHeaderMeta renders an itinerary's live total distance + ascent under a header title, in the same RowMetadata treatment the itinerary list row uses (the distance, an interpunct, then a TrendingUp-captioned ascent), so the header reads with the list at a glance.Guide
EditorSaveFooterEditorSaveFooter seats the published Save at the foot of the sidenav panel.Guide · Props
StagingCreateFooterStagingCreateFooter is the one sticky footer of the staging panel: the Create action that commits the import/suggest draft.Guide · Props
WaypointIconCircleWaypointIconCircle is the colored-disc button at the left of a waypoint editor row: it renders the waypoint's icon centered inside a circle filled with the waypoint's color, mirroring the on-map sprite the tile renderer paints.Guide · Props
SegmentGroupModalSegmentGroupModal is the mount guard for the segment-group form.Guide
DraftProvenanceBannerDraftProvenanceBanner is the informational callout shown above the staging form while an import or suggestion draft is being reviewed.Guide · Props
SuggestFormGuide
ZoneFormGuide
ZoneActionsMenuZoneActionsMenu is the three-dots action menu in the zone panel's sticky header, the zone-family counterpart to ItineraryActionsMenu.Guide · Props
ZoneSubHeaderZoneSubHeader is the band under the zone panel's header that answers "what does the public see of this zone?" and offers the one act that changes that answer.Guide
StudioSectionBoundaryGuide · Props
StudioPortalScopeStudioPortalScope gives one studio a portal node of its own, and points every menu, modal and tooltip drawn inside it at that node.Guide · Props
ShareViewModalGuide · Props
CopilotNoAccessCardCopilotNoAccessCard is the body the co-pilot shows to a reader whose role in the resource's organization does not write there: it says the co-pilot edits the map, and so is for an owner, an admin or a contributor.Guide

@mountaya/studio-react/headless

ComponentSummaryDocumented on
StudioProviderStudioProvider supplies the studio's bus, store, tool context and settings to everything under it.Guide · Props
StudioCopilotProviderGuide · Props
StudioNavigationBlockerProviderStudioNavigationBlockerProvider supplies the host's router binding to every guard beneath it.Guide · Props
StudioNotifyProviderGuide · Props
StudioOrganizationsProviderGuide · Props
StudioBillingGateProviderGuide · Props
StudioPluginsProviderStudioPluginsProvider supplies the registry to everything beneath it.Guide · Props

@mountaya/studio-react/copilot

ComponentSummaryDocumented on
CopilotPanelCopilotPanel is the studio's co-pilot: a full-height column docked over the left edge of its nearest positioned ancestor, which slides in when the co-pilot opens and out when it shuts.Guide

@mountaya/studio-react/embed

ComponentSummaryDocumented on
EmbedWizardGuide · Props
EmbedFieldControlEmbedFieldControl draws one field of the embed configuration as the control its kind calls for, controlled by config and reporting a change through onPatch.Guide · Props

@mountaya/studio-react/import

ComponentSummaryDocumented on
ImportItineraryContentImportItineraryContent is the studio sidenav body for the import INPUT step: the provider/file picker that produces a preview.Guide
ImportPreviewLegendImportPreviewLegend names the two strokes an import preview paints, because the map draws every routable segment twice (solid for the candidate that would be created, dashed for the one that would not), and an unlabelled second line reads as a mistake rather than as an offer.Guide
ImportRoutingGuideProviderImportRoutingGuideProvider owns the routing guide's open flag and renders the one dialog for the whole studio.Guide · Props
ImportRoutingGuideLinkImportRoutingGuideLink is the one door to the routing guide, rendered at both points in the import flow where the question comes up: beside the dropzone, where a reader has not yet seen what matching a recording to the trail network does, and beside the segment list, where the per-segment toggles act on it.Guide

@mountaya/studio-react/video

ComponentSummaryDocumented on
VideoExportWizardVideoExportWizard is the export-as-video wizard entry, gating the AI director on the video-organization-modes entitlement.Guide · Props