vitalikryzhenkous/connectiq-watchface-kit

🇬🇧 English · 🇷🇺 Русский
Build Garmin Connect IQ watch faces with Claude Code. It comes with a ready skill, slash commands, pixel-font tooling and a complete reference face that has been verified on a real Forerunner 945.
## What you need
Claude Code for the skill and commands. It's optional: the parts also work on their own, see below.
Python 3.9+ with pip install pillow
To build for a real watch: VS Code, the Monkey C extension, and Garmin's Connect IQ SDK Manager (free account). Setup guide: docs/build-and-run-mac.md.
A Garmin watch is optional. The SDK simulator is enough to start.
## Quick start (5 minutes)
bash
git clone https://github.com/vitalikryzhenkous/connectiq-watchface-kit.git
cd connectiq-watchface-kit
pip install pillow
claude
Then type in Claude Code:
/wf-new minimal amber digital face for fenix7 with steps and weather
Claude asks a few questions, shows a mockup, generates the project in faces/ / and tells you how to build it.
To build and run on your watch you need the free Garmin SDK. Follow docs/build-and-run-mac.md: VS Code + Monkey C extension + SDK Manager, then simulator, then sideload over USB.
## Commands
| Command | What it does |
| /wf-new | Designs a face: questions, SVG mockup, full project, PNG preview |
| /wf-preview | Renders a pixel-accurate PNG preview without the simulator |
| /wf-add-device | Adds devices (MIP/AMOLED, 240–454 px) |
| /wf-debug | Fixes compiler errors or an IQ! crash from CIQLOG.YML |
| /wf-location | Sets the sunrise/sunset location for sideload testing (offline lookup, city level) |
| /wf-release-check | Pre-release gate: automated checks plus a manual checklist before the store export |
| /wf-store | Prepares a Connect IQ Store release: screenshots and a listing in 4 languages |
The connectiq-watchface skill loads automatically for any Garmin/Connect IQ task inside this repo.
### Use it in all your projects
bash
mkdir -p ~/.claude/skills ~/.claude/commands
ln -s "$PWD/.claude/skills/connectiq-watchface" ~/.claude/skills/connectiq-watchface
ln -s "$PWD"/.claude/commands/wf-.md ~/.claude/commands/
## MCP server (Claude Desktop, Cursor, any MCP client)
bash
pip install -r mcp/requirements.txt
claude mcp add connectiq -- python3 "$PWD/mcp/server.py"
Tools: scaffoldface, genfont, renderpreview, lint, deviceinfo. It runs locally with no network access. Details are in mcp/README.md.
## ConnectIQ-Bench
A small eval that tests whether an LLM can write a working Monkey C watch face. It has 10 tasks from easy to hard, static checks, and an optional compile step with your local SDK.
bash
python3 bench/run.py --all --project templates/n3on-terminal
See bench/README.md.
## No Claude Code? Use the parts
| Path | Use |
| templates/n3on-terminal/ | Copy, change the UUID, build. Pure Monkey C. |
| scripts/genfont.py | Any TTF → crisp Connect IQ bitmap font (.fnt + .png) |
| scripts/genicon.py | Pixel launcher icon |
| scripts/previewn3on.py | Layout preview and store screenshots |