building

Compile the Matter SDK for Linux, macOS, ESP32, and nRF targets.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/renne/skills --skill building-renne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building
Source: https://github.com/renne/skills/tree/main/matter/building
Command: npx skills add https://github.com/renne/skills --skill building-renne

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the complex process of setting up a development environment and compiling the Matter SDK from source code, enabling developers to build and test Matter-enabled applications efficiently.

Core Features & Use Cases

  • Environment Setup: Guides users through installing necessary prerequisites for Linux, macOS, and Raspberry Pi.
  • Code Checkout & Updates: Provides commands for cloning and updating the Matter SDK repository, including platform-specific submodule handling.
  • Build System Configuration: Details how to use GN and Ninja for building the SDK, including debug and optimized builds.
  • Cross-Platform Compilation: Demonstrates the use of build_examples.py for compiling for various targets like ESP32 and nRF.
  • ZAP Tool Integration: Explains the installation and usage of the ZAP tool for cluster configuration and code generation.
  • Use Case: A developer needs to compile the latest Matter SDK for an ESP32 target to test a new feature. They can use this Skill to set up their environment, check out the code, and build the specific target.

Quick Start

Use the building skill to bootstrap the Matter SDK environment and build the all-clusters example for the linux-x64 target.

Frequently Asked Questions about building

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compile the Matter SDK from source for an embedded target?

To compile the Matter SDK from source, use the build_examples.py script for cross-platform compilation. It processes environment setup and builds specific embedded targets like ESP32 and nRF by handling GN and Ninja build system configurations automatically.

What do I need to set up a development environment for Matter SDK compilation?

Matter SDK compilation requires installing prerequisites on Linux, macOS, or Raspberry Pi. You must clone the repository with platform-specific submodule handling, install necessary dependencies, and configure GN and Ninja build systems before generating binaries.

Can I use GN and Ninja to configure debug and optimized Matter SDK builds?

Yes, GN and Ninja support configuring both debug and optimized Matter SDK builds. These build systems manage the compilation pipeline, allowing you to specify build arguments for target-specific outputs across Linux, macOS, and embedded platforms.

How does ZAP tool integration work for Matter development?

ZAP tool integration facilitates cluster configuration and code generation for Matter development. Installing and using the ZAP tool allows developers to define and generate the necessary application clusters required when compiling the Matter SDK from source.

What is the best way to handle Matter SDK submodule updates for different platforms?

Handling Matter SDK submodule updates requires executing specific checkout commands tailored to your target platform. The process involves cloning the repository and running targeted submodule initialization to ensure all platform-specific dependencies are correctly synchronized.