The only Developer refence so far is
https://wiki.openstack.org/wiki/StarlingX/Containers/HowToAddNewFluxCDAppInSTX, which focuses on building a StarlingX
App which uses FluxCD. The focus is more on build environment so the interaction with the App Framework itself was out of scope.
In an attempt demystify the StarlingX App <-> App Framework interaction I started a new page:
https://wiki.openstack.org/wiki/StarlingX/Containers/StarlingXAppsInternals .
It
is in no way complete work, the work is just at the beginning. The purpose would be to show examples on how to configure your app to have different behavior, explain what these behaviors are, list scenarios, general guidelines.