forum-sample-app

Surface a build-time value from metadata.json (e.g. version) into the QML UI, since the `logos` QML bridge exposes no module metadata. Threads the value through CMake (string(JSON …) + a compile definition) → a READONLY .rep PROP set in the backend constructor → a QML `backend.<prop>` binding. Use when the UI needs to display anything held in metadata.json — version, display_name, category — kept in sync from that single source.

Make one Logos module call (and subscribe to events from) another — declaring the dependency in metadata.json + flake.nix and reaching it through the generated typed `modules().<dep>` wrapper. Covers all three authoring flavors (universal core, universal ui_qml, explicit ui_qml plugin). Use when a module needs to invoke another module's methods/events (e.g. example_forum using delivery_module, forum_ui using forum_app).

Use the Logos delivery_module (liblogosdelivery / Waku messaging) from another module — bootstrap a node, subscribe to a content topic, send a payload, and handle the message events. Covers the createNode config, the synchronous-call + async-event model, and the plain-text send/receive recipe. Use when a module needs to send/receive messages over the Logos messaging network (e.g. example_forum broadcasting on a topic).

Restyle a Logos ui_qml module's QML view with the Logos design system — swap raw QtQuick.Controls + hardcoded hex colors for Logos.Controls components and Theme.palette/spacing/typography tokens. Covers the import path (no flake.nix change), the control swaps, the color/spacing/typography token mapping, and the LogosTextField API differences. Use when a module's Main.qml is styled with bespoke colors and you want it to match the design system.

Rename a Logos C++ module end to end — every file, identifier, and config field that must change so it still builds with `nix build .`. Covers both authoring flavors: universal "core" modules (impl class only) and "ui_qml" modules (C++ backend + .rep + QML view). Use when changing a module's name (e.g. "minimal" → "broadcast_module" or "ui_example" → "broadcast_app").