| 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. |
VeltoKit (gametriki repo)
Before any edit
- Read repo root
AGENTS.md for paths, GameInput contract, and anti-patterns.
- Read
VeltoKit/MotionSDK.swift and VeltoKit/GameInput.swift for API truth.
- For game behavior, read the matching
app/Games/*Game.swift and website/docs/examples/*.md.
Identity
- VeltoKit = Swift SDK in
VeltoKit/. gametriki = sample app in app/.
- Games use
GameInput only — never raw BLE Data in app/Games/.
- Triki UI =
app/UI/TrikiUI/ (menus, focus, hold). Not shipped as VeltoKit API.
Frame pipeline
BLE → MotionSDK.connect() → pollInput → GameInput → your game
motion.configureForPong()
let input = motion.pollInput(deltaTime: dt)
Helpers: TrikiRecipes.swift — TrikiSimplePong, TrikiUIPicker, TrikiGameActions, TrikiButtonGate.
Docs: website/docs/sdk/recipes.md.
MotionMode → games
| Mode | Games | Main fields |
|---|
.paddle | Pong, Quiz | posX, primaryAction |
.pointer | Dart | posX, posY, shotTriggered |
.gesture | Bowling | shotTriggered, throwPower |
Editing rules
- Minimal diffs; do not rename public API without request.
- Update
/// on touched Swift APIs; sync website/docs/ if behavior changes.
- Docs source:
website/docs/ (English). Site search: navbar ⌘K / Ctrl+K.
Docs index (repo paths)
- Overview:
website/docs/sdk/overview.md
- GameInput:
website/docs/sdk/game-input.md
- AI context:
website/docs/ai-context.mdx, AGENTS.md
