Skip to main content
A MiniApp is an external web application that opens in an iframe inside the main Exode app. A school connects it through a custom page. The SDK provides two-way communication between the mini app and the host via postMessage and helps you verify the signature of user data on your server.

Architecture

The host side of the bridge is implemented inside the main Exode app. The guest side (what the MiniApp developer includes) is @exode-team/sdk/miniapp.

Lifecycle

1

Loading the iframe

The main app opens the MiniApp by URL in an iframe and appends signed user data to the address — #exodeInitData=... (see Init Data).
2

Handshake

The MiniApp calls app.init() and sends its appId to the host. The host checks the message origin (for custom pages, the origin of the address from “App URL (iframe)”; appId can be anything in this case) and returns the context (user, school, theme, config).
3

Operation

The MiniApp sends commands (navigate, showSnackbar, …). The host pushes events (theme:changed, user:updated, …).
4

Shutdown

On unmount, the MiniApp calls app.destroy() — the bridge closes its listeners and releases resources.

What is available to a MiniApp

  • User profile (name, avatar, email, role, language)
  • School object
  • Current theme (light / dark), with a host 0.4+ — the school accent and colors
  • Platform (web / native), system (ios / android / web) and device (isDesktop / isMobile)
  • The frame position and the insets under the host chrome, the list of host capabilities
  • Navigation within the main app
  • Showing snackbar notifications
  • Controlling tabbar / header visibility
  • Closing the mini app
  • Since SDK 0.4 — the native chrome: the header with the ”…” menu, “Back”, the main button, the composer with a mic, popups, haptics, fullscreen, links and “Share”
  • Theme, user, school and config changes
  • Host route changes
  • iframe visibility and position changes (viewport:changed)
  • Presses in the host chrome: ”…” menu items, “Back”, the main button, composer submits

What’s next

ExodeMiniApp client

Vanilla JS client: init, route, ui, events.

Context and types

MiniAppContext structure, event and command types.

React hooks

Provider and reactive hooks for React apps.

Native look

The host header, “Back”, main button, composer, popups and haptics.

Init Data

Signed user data and how to verify it on your server.

Telegram Mini App

Auto sign-in via the ___uat parameter.

Updated: 2026-10-22 23:06 UTC