The Client Runtime
Learn what the Fluxyn runtime does in the browser, how it starts, and how it processes events safely.
The client runtime is the browser script that makes Fluxyn real on the page.
It is responsible for:
- booting with the correct application id
- loading the published configuration for that app
- attaching the listeners the application allows
- reading the data layer and page state
- executing matching flows when events happen
Startup Order and Network Footprint
At a high level, startup looks like this:
- The script loads with your
appId. - The runtime fetches the published payload for that application.
- It evaluates application-level settings such as listeners and event queueing.
- It attaches the listeners the app needs.
- It processes any relevant existing
window.dataLayerstate.
The runtime is intentionally small in scope. It does not carry Studio UI behavior with it. Its job is execution, not editing.
Script Snippet Installation
For production, Fluxyn currently ships through the CDN script shown in the Application Script tab.
<script src="https://cdn.fluxyn.net/latest/rt.js?appId=YOUR_APP_ID"></script>Live Preview uses the runtime debug relay to test the saved application branch before production release.
Event Processing Integrity
The runtime treats different kinds of pushes differently.
- A payload with an event name can start a flow if a trigger matches it.
- A payload without a trigger-worthy event may still update state for later flows.
- Each execution gets access to both the current event data and the current page state.
Event Queueing
Some implementations need to delay work until a setup flow has completed. Fluxyn supports that through application-level event queueing.
When queueing is enabled:
- incoming events are queued by default
- only Event Trigger nodes with
Bypass queueenabled can run before the queue is released - queued events replay after a flow calls Release Queue
- queued events replay in the same order they originally arrived
If queueing is disabled:
- all events run normally
- Fluxyn still updates consent state when your consent-update flow runs
The runtime stores queued events in sessionStorage and trims the oldest items automatically if storage pressure gets too high.