KinesteX

Complete UX Customization

Customize the Complete UX (Main View) home page experience. Applies to: Main only — no other integration option reads this parameter.


ParameterTypeDefaultApplies toWhat it does internally
challenges_homearrayper-planC defaultsMainReplaces the two challenge/game cards on the Complete UX home screen. When omitted, the cards are chosen from built-in defaults based on planC

challenges_home Configuration:


The challenges_home parameter customizes the challenge/game cards displayed on the home screen of the Complete UX experience. Pass exactly 2 objects in the array — the layout and the home guide are designed for two cards.


Array Object Structure:

PropertyTypeRequiredDescription
idstringYesExercise ID for challenges, or game ID for games
namestringYesDisplay name shown verbatim on the card (a value starting with home. is treated as a translation key instead)
isGamebooleanYesSet to true for games, false for challenges
imagestringNoCard image URL. Falls back to a built-in image when omitted

Available Games:

  • balloonpop - Balloon Pop game
  • aliensquatshooter - Alien Squat Shooter game
  • colorchase - Color Chase game

Combination Options:

  • Two challenges (both with isGame: false)
  • Two games (both with isGame: true)
  • One challenge + one game (mixed isGame values)

Note: You can pass any exercise ID as a challenge. When specifying a game, ensure isGame is set to true.

Complete UX Home Page Customization
Swift example:
1// Customize challenges on Complete UX home page
2let exerciseId = "your-exercise-id" // Get from Content API
3let exerciseName = "Your Exercise Name"
4
5kinestex.createMainView(
6    customParams: [
7        "challenges_home": [
8            ["id": exerciseId, "name": exerciseName, "isGame": false],
9            ["id": "balloonpop", "name": "Balloon Pop", "isGame": true]
10        ]
11    ]
12)