[network/ruqola/link-preview-compact-card] /: CLAUDE.md: document QT_PLUGIN_PATH for running from a build tree

Git commit c057a00d798d889e808f956b2c477b85c235a85d by Till Adam.
Committed on 26/07/2026 at 16:47.
Pushed by tilladam into branch 'link-preview-compact-card'.

CLAUDE.md: document QT_PLUGIN_PATH for running from a build tree

Running the app from a build tree (not installed) needs QT_PLUGIN_PATH
pointing at both Qt's plugin dir and the build's own ruqolaplugins dir,
otherwise plugins - notably the authentication plugins - fail to load
and login silently offers nothing. Record the incantation, plus a note
that build-craft (CraftRoot) is the working toolchain here while the
build-dev* presets' test binaries crash on a Qt ABI mismatch.

Claude-Session: https://claude.ai/code/session_01CxPKubYxDEBsJe57Ue8GaF

M  +16   -0    CLAUDE.md

https://invent.kde.org/network/ruqola/-/commit/c057a00d798d889e808f956b2c477b85c235a85d

diff --git a/CLAUDE.md b/CLAUDE.md
index 7d854c575b..a65a6c058c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -39,6 +39,22 @@ the top level contains interactive GUI test programs (not CTest tests).
 Install prefix defaults to `$KF6`. ASAN suppressions:
 `LSAN_OPTIONS=suppressions=../sanitizers.supp ./bin/<test>`.
 
+Running the app from a build tree (not installed): Qt must be told where
+its plugins live or the app fails to load plugins (notably the
+authentication plugins, so login silently offers nothing). Set
+`QT_PLUGIN_PATH` to the Qt/KF plugin dir **and** the build's own
+`ruqolaplugins` dir, e.g. for the CraftRoot toolchain:
+
+```bash
+QT_PLUGIN_PATH=$HOME/Code/kde/CraftRoot/plugins:$PWD/build-craft/bin \
+  open -n build-craft/bin/ruqola.app   # macOS .app bundle
+```
+
+(On this machine the working toolchain is CraftRoot — `build-craft`; the
+`build-dev*` presets point at a Homebrew Qt that ABI-mismatches the
+CraftRoot KF6 at runtime, so their test binaries crash in QtCore even
+though they compile. Build and run tests in `build-craft`.)
+
 ## Pre-commit hooks
 
 `pre-commit` is auto-installed by CMake when configuring from a git