A GitHub Action that sets up the Pebble (Core Devices) SDK build environment and, optionally, builds your Pebble app or watchface into a .pbw.
It behaves like setup-node / setup-go: it installs the toolchain so subsequent steps can run pebble commands, and with build: true it runs pebble build for you and reports the resulting .pbw.
Linux only. Runs on GitHub-hosted
ubuntu-latest(and compatible self-hosted Linux runners). It sets up the build environment — it does not install the QEMU emulator, sopebble install --emulator/ screenshots are out of scope.
steps:
- uses: actions/checkout@v7
- uses: levonn-dev/setup-pebble@v1.0.2
- run: pebble build # or any other pebble commandsteps:
- uses: actions/checkout@v7
- uses: levonn-dev/setup-pebble@v1.0.2
id: pebble
with:
build: 'true'
- uses: actions/upload-artifact@v7
with:
name: app-pbw
path: ${{ steps.pebble.outputs.pbw-path }}steps:
- uses: actions/checkout@v7
- uses: levonn-dev/setup-pebble@v1.0.2
with:
build: 'true'
working-directory: watchfaces/my-face
sdk-version: '4.4' # pin instead of "latest"| Name | Default | Description |
|---|---|---|
build |
false |
Run pebble build after setup to produce a .pbw. |
working-directory |
. |
Project directory (contains package.json + wscript). Used only when build: true. |
sdk-version |
latest |
SDK version passed to pebble sdk install. |
cache |
true |
Cache ~/.pebble-sdk and the pebble-tool install across runs. |
| Name | Description |
|---|---|
pbw-path |
Absolute path to the built .pbw. Set only when build: true. |
- Installs the system libraries the SDK needs (
libsdl2,libglib2.0,libpixman-1,zlib1g,libsndio). Node.js is assumed to be present (it is preinstalled on GitHub-hostedubuntu-latest). - Installs
uvand the Pebble CLI (uv tool install --force pebble-tool --python 3.13;--forcekeeps thepebbleshim correct across cache restores). - Runs
pebble sdk install <sdk-version>, which downloads the ARM toolchain and SDK into~/.pebble-sdk. - If
build: true, runspebble buildinworking-directoryand exposes the resulting.pbwas thepbw-pathoutput.
With cache: true (the default), the action caches ~/.pebble-sdk (SDK + toolchain) and ~/.local/share/uv (the pebble-tool install and its Python), keyed by runner OS and sdk-version.
With
sdk-version: latest, the cached SDK is reused until the cache key changes. Pinsdk-versionfor fully reproducible builds, or setcache: falseto always fetch fresh.
A typical workflow for those projects:
name: CI
on:
push:
branches: [main]
pull_request:
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: levonn-dev/setup-pebble@v1.0.2
id: pebble
with:
build: 'true'
sdk-version: '4.9.169'
- uses: actions/upload-artifact@v7
with:
name: pebble-adventure-pbw
path: ${{ steps.pebble.outputs.pbw-path }}
if-no-files-found: errorA minimal watchface used by this repo's test workflow lives in
examples/sample-watchface. The
Test setup-pebble workflow exercises both
build: false (setup only) and build: true (setup + build) against it.
MIT © 2026 levonn-dev