idf-ci 0.x Documentation

This documentation is for idf-ci. idf-ci is a tool A tool designed to streamline the CI/CD of ESP-IDF projects, with support for both GitLab CI/CD and GitHub Actions.

Key Features:

  • Sensible Defaults

    Easy setup with default settings for idf-build-apps and pytest-embedded.

  • Build Management

    Build ESP-IDF apps for multiple targets (ESP32, ESP32-S2, ESP32-C3, etc.) with parallel builds and smart filtering based on changed files or test needs.

  • Test Management

    Run pytest with ESP-IDF configs, including target-specific test discovery and marker filtering.

  • GitLab CI/CD Integration

    Full pipeline support with artifacts, S3 uploads, and auto-generated jobs for builds and tests.

  • GitHub Actions Integration

    Generate test matrix from project settings.

Explanations

Guides

References