snippetbashTip

pio ci — Build PlatformIO projects with an arbitrary source code structure. This will create a new temporary

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandbuildcliprojectswithpio ciplatformioarbitrary

Problem

How to use the pio ci command: Build PlatformIO projects with an arbitrary source code structure. This will create a new temporary project which the source code will be copied into. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_ci.html>.

Solution

pio ci — Build PlatformIO projects with an arbitrary source code structure. This will create a new temporary project which the source code will be copied into. More information: <https://docs.platformio.org/en/latest/core/userguide/cmd_ci.html>.

Build a PlatformIO project in the default system temporary directory and delete it afterwards:

pio ci {{path/to/project}}

Build a PlatformIO project and specify specific libraries:

pio ci {{[-l|--lib]}} {{path/to/library_directory}} {{path/to/project}}

Build a PlatformIO project and specify a specific board (pio boards lists all of them):

pio ci {{[-b|--board]}} {{board}} {{path/to/project}}

Build a PlatformIO project in a specific directory:

pio ci --build-dir {{path/to/build_directory}} {{path/to/project}}

Build a PlatformIO project and don't delete the build directory:

pio ci --keep-build-dir {{path/to/project}}

Build a PlatformIO project using a specific configuration file:

pio ci {{[-c|--project-conf]}} {{path/to/platformio.ini}}

Code Snippets

Build a PlatformIO project in the default system temporary directory and delete it afterwards

pio ci {{path/to/project}}

Build a PlatformIO project and specify specific libraries

pio ci {{[-l|--lib]}} {{path/to/library_directory}} {{path/to/project}}

Build a PlatformIO project and specify a specific board (`pio boards` lists all of them)

pio ci {{[-b|--board]}} {{board}} {{path/to/project}}

Build a PlatformIO project in a specific directory

pio ci --build-dir {{path/to/build_directory}} {{path/to/project}}

Build a PlatformIO project and don't delete the build directory

pio ci --keep-build-dir {{path/to/project}}

Context

tldr-pages: common/pio ci

Revisions (0)

No revisions yet.