Meson

mohitmishra786/low-level-dev-skills/skills/build-systems/meson

by mohitmishra786bdc58472fa9fNo license253 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 3 months ago

Meson build system skill for C/C++ projects. Use when setting up a Meson project, configuring build options, managing dependencies with the wrap system, cross-compiling, or integrating Meson with CI. Activates on queries about meson setup, meson compile, meson wrap, meson test, cross-file, meson.build, or migrating from CMake/Autotools to Meson.

Instructions onlySoftware Development

AI-generated overview

Guides agents through Meson build system setup, options, wrap dependencies, and cross-compilation for C/C++ projects.

What it does: Explains how to configure, build, test, and install C/C++ projects with Meson, including build types, build options, and meson.build structure. Covers dependency management through the wrap system, cross-compilation with cross files, and a CMake-to-Meson migration cheatsheet. Produces command sequences, configuration snippets, and reference guidance rather than files.
When to use it: Use when setting up a Meson project, configuring build options, adding or troubleshooting wrap dependencies, cross-compiling, or migrating a project from CMake or Autotools to Meson.
Requirements: No scripts are shipped; instructions only. Requires the Meson build system and Ninja installed, plus a C/C++ toolchain and, for cross-compilation, a cross toolchain and sysroot. Network access is needed for wrap installs that download sources from wrapdb.

Meson

Purpose

Guide agents through Meson project setup, build configuration, the wrap dependency system, and cross-compilation — covering the build system used by GLib, systemd, GStreamer, Mesa, and many major C/C++ projects.

Triggers

"How do I set up a Meson build?"
"How do I add a dependency in Meson?"
"How do I cross-compile with Meson?"
"Meson wrap isn't finding my dependency"
"How do I configure build options in Meson?"
"How do I migrate from CMake/Autotools to Meson?"

Workflow

1. Project setup

bash

# Configure (source-dir, build-dir are positional)meson setup builddir
# With optionsmeson setup builddir \    --buildtype=release \    --prefix=/usr/local \    -Db_lto=true \    -Db_sanitize=address
# Reconfigure (change options on existing builddir)meson configure builddir -Dbuildtype=debug
# Show all available optionsmeson configure builddir

# Configure (source-dir, build-dir are positional)meson setup builddir
# With optionsmeson setup builddir \    --buildtype=release \    --prefix=/usr/local \    -Db_lto=true \    -Db_sanitize=address
# Reconfigure (change options on existing builddir)meson configure builddir -Dbuildtype=debug
# Show all available optionsmeson configure builddir

2. Build and test

bash

# Build (from source directory)meson compile -C builddir
# Or enter builddir and use ninja directlycd builddir && ninja
# Run testsmeson test -C builddirmeson test -C builddir --verbose          # show test outputmeson test -C builddir -t 5               # 5x timeout multipliermeson test -C builddir --suite unit       # run only 'unit' suite
# Installmeson install -C builddir# Dry runmeson install -C builddir --dry-run

# Build (from source directory)meson compile -C builddir
# Or enter builddir and use ninja directlycd builddir && ninja
# Run testsmeson test -C builddirmeson test -C builddir --verbose          # show test outputmeson test -C builddir -t 5               # 5x timeout multipliermeson test -C builddir --suite unit       # run only 'unit' suite
# Installmeson install -C builddir# Dry runmeson install -C builddir --dry-run

3. meson.build structure

python

project('myapp', 'c', 'cpp',  version : '1.0.0',  default_options : [    'c_std=c11',    'cpp_std=c++17',    'warning_level=2',  ])
# Find system dependenciesglib_dep = dependency('glib-2.0', version : '>=2.68')threads_dep = dependency('threads')
# Include directoriesinc = include_directories('include')
# Librarymylib = static_library('mylib',  sources : ['src/lib.c', 'src/util.c'],  include_directories : inc,)
# Executableexecutable('myapp',  sources : ['src/main.c'],  include_directories : inc,  link_with : mylib,  dependencies : [glib_dep, threads_dep],  install : true,)
# Teststest('basic', executable('test_basic',  sources : ['tests/test_basic.c'],  link_with : mylib,))

project('myapp', 'c', 'cpp',  version : '1.0.0',  default_options : [    'c_std=c11',    'cpp_std=c++17',    'warning_level=2',  ])
# Find system dependenciesglib_dep = dependency('glib-2.0', version : '>=2.68')threads_dep = dependency('threads')
# Include directoriesinc = include_directories('include')
# Librarymylib = static_library('mylib',  sources : ['src/lib.c', 'src/util.c'],  include_directories : inc,)
# Executableexecutable('myapp',  sources : ['src/main.c'],  include_directories : inc,  link_with : mylib,  dependencies : [glib_dep, threads_dep],  install : true,)
# Teststest('basic', executable('test_basic',  sources : ['tests/test_basic.c'],  link_with : mylib,))

4. Dependency management with wrap

bash

# Search for a wrapmeson wrap search zlib
# Install a wrap (downloads .wrap file from wrapdb)meson wrap install zlibmeson wrap install gtest
# List installed wrapsmeson wrap list
# Update all wrapsmeson wrap update

# Search for a wrapmeson wrap search zlib
# Install a wrap (downloads .wrap file from wrapdb)meson wrap install zlibmeson wrap install gtest
# List installed wrapsmeson wrap list
# Update all wrapsmeson wrap update

In meson.build:

python

# Use wrap as fallback if system lib not foundzlib_dep = dependency('zlib',  fallback : ['zlib', 'zlib_dep'],  # [wrap_name, dep_variable])
# Force wrap (for reproducible builds)zlib_dep = dependency('zlib',  fallback : ['zlib', 'zlib_dep'],  default_options : ['default_library=static'],)

# Use wrap as fallback if system lib not foundzlib_dep = dependency('zlib',  fallback : ['zlib', 'zlib_dep'],  # [wrap_name, dep_variable])
# Force wrap (for reproducible builds)zlib_dep = dependency('zlib',  fallback : ['zlib', 'zlib_dep'],  default_options : ['default_library=static'],)

subprojects/zlib.wrap structure:

ini

[wrap-file]directory = zlib-1.3source_url = https://zlib.net/zlib-1.3.tar.gzsource_hash = <sha256>
[provide]zlib = zlib_dep

[wrap-file]directory = zlib-1.3source_url = https://zlib.net/zlib-1.3.tar.gzsource_hash = <sha256>
[provide]zlib = zlib_dep

5. Build options

Define in meson_options.txt (or meson.options in Meson ≥1.1):

python

option('with_tests', type : 'boolean', value : true,  description : 'Build unit tests')
option('backend', type : 'combo',  choices : ['opengl', 'vulkan', 'software'],  value : 'opengl',  description : 'Rendering backend')
option('max_connections', type : 'integer',  min : 1, max : 1024, value : 64)

option('with_tests', type : 'boolean', value : true,  description : 'Build unit tests')
option('backend', type : 'combo',  choices : ['opengl', 'vulkan', 'software'],  value : 'opengl',  description : 'Rendering backend')
option('max_connections', type : 'integer',  min : 1, max : 1024, value : 64)

Use in meson.build:

6. Cross-compilation

Create a cross file (cross/arm-linux.ini):

ini

[binaries]c = 'arm-linux-gnueabihf-gcc'cpp = 'arm-linux-gnueabihf-g++'ar = 'arm-linux-gnueabihf-ar'strip = 'arm-linux-gnueabihf-strip'pkgconfig = 'arm-linux-gnueabihf-pkg-config'
[properties]sys_root = '/path/to/sysroot'
[host_machine]system = 'linux'cpu_family = 'arm'cpu = 'cortex-a9'endian = 'little'

[binaries]c = 'arm-linux-gnueabihf-gcc'cpp = 'arm-linux-gnueabihf-g++'ar = 'arm-linux-gnueabihf-ar'strip = 'arm-linux-gnueabihf-strip'pkgconfig = 'arm-linux-gnueabihf-pkg-config'
[properties]sys_root = '/path/to/sysroot'
[host_machine]system = 'linux'cpu_family = 'arm'cpu = 'cortex-a9'endian = 'little'

7. CMake migration cheatsheet

CMake	Meson equivalent
`add_executable`	`executable()`
`add_library`	`library()` / `static_library()` / `shared_library()`
`target_include_directories`	`include_directories` arg in target
`target_link_libraries`	`dependencies` / `link_with`
`find_package`	`dependency()`
`option()`	`option()` in `meson_options.txt`
`add_subdirectory`	`subdir()`
`install(TARGETS ...)`	`install : true` in target

For wrap patterns and subproject configuration, see references/meson-wrap.md [blocked].

Related skills

Use skills/build-systems/cmake when CMake is required or preferred
Use skills/build-systems/ninja — Meson uses Ninja as its backend
Use skills/compilers/cross-gcc for cross-compiler toolchain setup
Use skills/compilers/gcc or skills/compilers/clang for compiler flag context

Source and attribution

Source:mohitmishra786/low-level-dev-skillsinskills/build-systems/mesonat commitbdc5847

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

`--buildtype`	Equivalent flags
`debug` (default)	`-O0 -g`
`debugoptimized`	`-O2 -g`
`release`	`-O3 -DNDEBUG`
`minsize`	`-Os -DNDEBUG`
`plain`	No flags added

Meson

Meson

Purpose

Triggers

Workflow

1. Project setup

2. Build and test

3. meson.build structure

4. Dependency management with wrap

5. Build options

6. Cross-compilation

7. CMake migration cheatsheet

Related skills

Source and attribution

More from mohitmishra786/low-level-dev-skills

Zig Debugging

Simd Intrinsics

Zig Cross

Rustc Basics

Zig Cinterop

Zig Build System

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices