KinesteX

Loading Screen

Customize the loading screen, including the native overlay color shown while the view first loads. Applies to: All integrations: the loading screen is shown while any view verifies and downloads resources (and on the custom workout's loading screen).


ParameterTypeDefaultApplies toWhat it does internally
loadingStickmanColorstring#00FF0BAllColor of the animated stickman
loadingBackgroundColorstringBlack (dark) / White (light)AllLoading screen background color
loadingTextColorstringWhite (dark) / Black (light)AllColor of the loading text and progress messages

Color format: a bare 6-character hex value (e.g. "1A1A2E") gets a # added; #RRGGBB and CSS color names also work. Avoid 3-character shorthand hex ("fff") without #: it is passed through as-is and is not valid CSS.


SDK Support:

  • Swift, Kotlin, Flutter: the IStyle object of the create call
  • React Native, React: the style object in data
  • HTML/JS: top-level keys of the launch object

Native Loading Overlay (Swift): the SDK shows a native overlay on top of the WebView until the page has loaded, so users never see a blank screen.


  • The overlay hides when the kinestex_loaded message arrives
  • Overlay color priority:

1. loadingBackgroundColor if set

2. white if style = "light"

3. black if style = "dark" (default)


IStyle Properties:


PropertyTypeDefaultDescription
styleString?"dark"Base theme style ("dark" or "light")
themeNameString?nullTheme name (Theme & Appearance)
loadingStickmanColorString?nullColor of the loading stickman
loadingBackgroundColorString?nullBackground color while loading
loadingTextColorString?nullText color while loading
Loading Screen Customization
Swift example:
1kinestex.createWorkoutView(
2    workout: "Fitness Lite",
3    user: nil,
4    style: IStyle(
5        style: "dark",
6        loadingStickmanColor: "#FF6B00",
7        loadingBackgroundColor: "#1A1A2E",
8        loadingTextColor: "#FFFFFF"
9    ),
10    isLoading: $isLoading,
11    onMessageReceived: { message in /* ... */ }
12)