compile-examples.yml

# Compiles every sketch in examples/ on each push and pull request, so a change
# that breaks the library (or an example) is caught before it lands. This is the
# floor of CI for this published Arduino library; off-device unit tests for the
# pure-logic classes (MovingAverageFilter, Shape collision, ColorName) are a
# planned follow-up.
#
# Uses the official arduino/compile-sketches action.
name: Compile Examples

on:
  push:
    paths:
      - "src/**"
      - "examples/**"
      - ".github/workflows/compile-examples.yml"
  pull_request:
    paths:
      - "src/**"
      - "examples/**"
      - ".github/workflows/compile-examples.yml"
  # Allow manual runs from the Actions tab.
  workflow_dispatch:

jobs:
  compile:
    name: ${{ matrix.board.fqbn }}
    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        board:
          # The verified floor (see CLAUDE.md). To extend coverage, add entries
          # here once confirmed compiling, e.g.:
          #   - fqbn: esp32:esp32:esp32
          #     platform-name: esp32:esp32
          #     platform-url: https://espressif.github.io/arduino-esp32/package_esp32_index.json
          - fqbn: arduino:avr:uno
            platform-name: arduino:avr

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Compile examples
        uses: arduino/compile-sketches@v1
        with:
          fqbn: ${{ matrix.board.fqbn }}
          platforms: |
            - name: ${{ matrix.board.platform-name }}
          # Install this repo as a library (source-path: ./) alongside the
          # Adafruit dependencies the examples need. Adafruit SSD1306 pulls in
          # Adafruit GFX and Adafruit BusIO, but we list them explicitly so a
          # dependency resolution change upstream can't silently break the build.
          libraries: |
            - source-path: ./
            - name: Adafruit SSD1306
            - name: Adafruit GFX Library
            - name: Adafruit BusIO
          sketch-paths: |
            - examples
          enable-warnings-report: true
          verbose: false