Pebble App Framework

The shared framework behind my Pebble watchfaces and watchapps: the device C, the PebbleKit JS runtime and Clay config pieces, and the build tooling every face uses. Setup and usage are in the README on GitHub.

v4.6.0
v4.6.0 @ f530a39
built 2026-10-17

Start Here

CGuides

How It Works →

Each page follows one piece of the framework from end to end: what it does for a face, how it does it, and the trade-offs behind it.

Tools

CLIpaf

The paf Command

Pins each family or face to its own framework tag, then builds, generates, and checks it in place. Install, commands, and workflows.

pebble-app-framework-clipaf/ →

Reference

CDoxygen

Device API

The half of the framework that runs on the watch. Panels, stores, the clock, and the message formats the phone sends.

src/c/core · src/c/pebblec/ →

TSTypeDoc

Phone API

The PebbleKit JS runtime. Weather, stocks, calendar, the send queue, and the Clay settings pieces.

ts/ · exported onlyts/ →

Test Coverage

Cgcovr

Host C Specs

Which lines of the framework's C the Unity specs reach, built with plain gcc and no Pebble SDK.

make -C tests/c/spec coveragecoverage/c/ →

TSVitest v8

TypeScript Specs

Which lines of the phone runtime and the build tools the Vitest suite reaches.

npm run test:coveragecoverage/ts/ →