README.md

Collider brings modern package management to Meson's native wrap ecosystem.

Rather than replacing Meson's dependency model, Collider extends it: automatic dependency resolution, lockfiles, and a streamlined day-to-day workflow, fully compatible with wraps and WrapDB.

It also lets teams run private WrapDB-compatible package repositories and publish to them, so you can build your own package ecosystem on the same infrastructure Meson already understands.

Documentation: collider.ee

Features

• Automatic dependency resolution for Meson wrap projects.
• Publishable wrap repositories.
• Host your own WrapDB-compatible package repository.
• Lockfiles for reproducible builds.
• Offline dependency cache.
• Compatible with WrapDB.

Why Collider?

Meson provides WrapDB and subprojects, but dependency management across multiple repositories can become difficult:

• Wrap files must be maintained manually.
• Offline builds require prefetching sources.
• Publishing reusable wraps is cumbersome.

Collider adds a lightweight package workflow on top of Meson's wrap system:

• Publishable wrap repositories.
• Self-hosted WrapDB-compatible registries.
• Reproducible dependency lockfiles.
• Offline dependency caching.

Requirements

• Python 3.10+
• Meson 1.8.5+ (and Ninja)
• See pyproject.toml for Python dependency versions.

Installation

pip install collider-wraps

From source (development)

git clone git@github.com:MaxandreOgeret/collider.git
cd collider
uv venv
source .venv/bin/activate
uv sync

Quick start

From the root of a Meson project (next to meson.build):

collider init                                                   # create collider.json
collider repo add wrapdb wrap https://wrapdb.mesonbuild.com/v2/ # configure a repository
collider pkg add zlib                                           # add a dependency
collider setup                                                  # configure the Meson build
collider lock                                                   # write collider.lock for reproducible installs

See the Quick Start guide for a full walkthrough.

Documentation

Full documentation lives at collider.ee:

• Getting started: install and first steps.
• User guide: managing packages, repositories, publishing, locking, offline mode, and serving.
• Configuration: config.json, collider.json, and collider.lock.
• CLI reference: every command, flag, and exit code.
• Contributing: development setup and pull request checks.

License

Apache-2.0
Copyright 2026 MOG Robotics OÜ