bazaar/CONTRIBUTING.md
2026-09-22 14:22:49 +07:00

4.1 KiB

Contributing Guide

Welcome! We are glad that you are here! 💖

If you are here to contribute translations, please refer to the Damned Lies Module.

For code, first make sure to read the style rules.

The easiest way to run Bazaar from source is to use the foundry cli:

foundry run

Alternatively, you can do:

just build-flatpak

Or without flatpak, if your system permits it:

meson setup build --prefix=/usr --libdir=/usr/lib64
ninja -C build
sudo ninja -C build install
bazaar

You will need the following dependencies installed, along with a C compiler, meson, and ninja:

Dep Name pkg-config Name Min Version Justification
gtk4 gtk4 4.22.1 GUI
libadwaita libadwaita-1 1.8 GNOME styling
libdex libdex-1 1.2.0 Async helpers
flatpak flatpak 1.9 Flatpak installation management
appstream appstream 1.0 Interpret application metadata
xmlb xmlb 0.3.4 Handle binary xml appstream bundles/Parse plain xml
glycin glycin-2 2.0 Decode image URIs
glycin-gtk4 glycin-gtk4-2 2.0 Convert glycin frames to texture representations
libyaml yaml-0.1 0.2.5 Parse YAML configs
libsoup libsoup-3.0 3.6.0 HTTP operations
json-glib json-glib-1.0 1.10.0 Parse some HTTP replies
md4c md4c 0.5.1 Parse markdown (.md)
gtksourceview gtksourceview-5 5.17 Render markdown code blocks
webkitgtk webkitgtk-6.0 2.50.2 Render web views
libsecret libsecret-1 0.20 Store Flathub account information
libproxy libproxy-1.0 0.5 Parse proxies for networking operations
malcontent malcontent-0 0.12.0 Adhere to system parental controls settings
libsystemd libsystemd 245 Utilities for bazaar-daemon

There is a script for installing all of these on fedora.

Right now there is no hard rules on commit messages. Just be descriptive.

If anything is confusing here, please do not be afraid to open an issue. We are more than happy to answer questions.