Documentation

Everything you need to write, build, review, and publish community packages for Blueberry Linux.

The client

bur is a single, standalone binary that works alongside bpm. It is installed on demand and is not part of the base system.

bpm install bur          # install the client
bur search <name>        # search community packages
bur info <name>          # show package details
bur install <name>       # build and install from repo1
bur build .              # build the recipe in the current directory
bur submit .             # submit a recipe for review
bur publish .            # publish an approved package

Recipe format

Recipes use the bpm.toml format. A recipe declares package metadata, one or more sources with pinned sha256 checksums, and build / package steps.

[package] — name, version, release, summary, license, dependencies.
[[source]] — one per source; each with a url and sha256.
[steps] — build and package shell snippets.

Roles

Role	What it can do
Contributor	The default. Create packages, submit recipes, and apply to contribute to others' packages.
Package owner	The author of a package. Edits their own package freely and approves contribution requests to it.
Maintainer	Reviews and approves recipe submissions from any contributor.
Author	The top role. Full administrative control over packages, users, and publishing.

Trusted contributors

Once you have twenty approved recipes, you become a trusted contributor and your future submissions are published without review.

Review and publishing

A submission is reviewed by a maintainer (unless you are trusted, or it is your own package). After approval, the built .bpm is published to repo1.blueberrylinux.org, the community mirror — kept separate from the official repo.mmzsigmond.me.