| name | veltokit |
|---|---|
| description | VeltoKit BLE motion SDK and gametriki sample app. Use when editing Swift in VeltoKit/, app/, or website/docs/, or when answering questions about GameInput, MotionSDK, MotionMode, Triki UI, or BLE integration. |
- Read repo root
AGENTS.mdfor paths,GameInputcontract, and anti-patterns. - Read
VeltoKit/MotionSDK.swiftandVeltoKit/GameInput.swiftfor API truth. - For game behavior, read the matching
app/Games/*Game.swiftandwebsite/docs/examples/*.md.
- VeltoKit = Swift SDK in
VeltoKit/. gametriki = sample app inapp/. - Games use
GameInputonly — never raw BLEDatainapp/Games/. - Triki UI =
app/UI/TrikiUI/(menus, focus, hold). Not shipped as VeltoKit API.
BLE → MotionSDK.connect() → pollInput → GameInput → your game
motion.configureForPong() // or Menu / PointerGame / GestureGame
let input = motion.pollInput(deltaTime: dt)Helpers: TrikiRecipes.swift — TrikiSimplePong, TrikiUIPicker, TrikiGameActions, TrikiButtonGate.
Docs: website/docs/sdk/recipes.md.
| Mode | Games | Main fields |
|---|---|---|
.paddle |
Pong, Quiz | posX, primaryAction |
.pointer |
Dart | posX, posY, shotTriggered |
.gesture |
Bowling | shotTriggered, throwPower |
- Minimal diffs; do not rename public API without request.
- Update
///on touched Swift APIs; syncwebsite/docs/if behavior changes. - Docs source:
website/docs/(English). Site search: navbar⌘K/Ctrl+K.
- Overview:
website/docs/sdk/overview.md - GameInput:
website/docs/sdk/game-input.md - AI context:
website/docs/ai-context.mdx,AGENTS.md