Elonn Docs Platform Documentation

web

web.elonn.local is the browser runtime shell for Elonn. Production is web.elonn.com.

Web is a thin runtime. It does not own identity, world state, social state, calendar state, maps data, or persistence authority. It consumes the JSON contract from world.elonn.local and renders the carry stack, docks, rails, field controls, and field layer in the browser.

Current Web uses the surface_runtime contract for the primary carry SurfaceStack. The implementation proved reusable stack mounting in rails; the intended architecture keeps both siderails as stacks: a left runtime/user panel stack and a right control stack that shows service navigation in normal mode and a vertical Field flip stack when the lower dock selects Field. Panel content is loaded through World-provided runtime panel URLs.

For the Web runtime proof path, see Current State.

Owns

  • browser rendering of the primary SurfaceStack, docks, rails, field controls, and field layer
  • client-side runtime state
  • UI interactions and navigation

Role in the stack

  1. Validates the auth cookie against api.elonn.local
  2. Loads the world contract from world.elonn.local
  3. Renders surface_runtime into the center carry stack
  4. Renders the left rail runtime/member panel stack
  5. Renders the right rail service navigation stack from the focused surface, or the Field control stack when Field is active
  6. Renders the field layer as a 360-degree browser panorama with a synthetic horizon, north marker, and live Places filtering
  7. Runtime service actions route through world — web does not call social, messages, maps, or time directly for those actions

For Find, Web must render finding_surface objects from surface_runtime. Web must not call Find directly and must not inspect Brave, OSM, Nominatim, Overpass, or provider payloads. Drag, resize, focus, and detach operations go through World placement commands so Surface remains the persistence authority.

The browser field is explicitly a demo runtime layer. It consumes the same nearby-place data path as the Android runtime, but it presents that data through a pointer-driven panorama rather than a live camera/sensor overlay.

Presence identifier

web.elonn is the presence runtime identifier — the string that appears in the runtime field of a presence record when a member is using the browser runtime.

Canonical terms

  • web — the browser runtime service
  • runtime — the execution environment
  • carry — user-following layer web renders
  • field — spatial layer web renders
  • panel — service-owned content loaded inside a surface