charlesdobson
commented
1 year ago Thanks for your feedback!
"App Bridge" and "App Bridge Library" are one and the same. The top-level page (/api/app-bridge) is more of a product/marketing explainer of what App Bridge is, where the /api/app-bridge-library page is the API reference that dives deeper into technical information.
I've fixed the broken links that you've pointed out - that should go out today or tomorrow.
I'll take the rest of your feedback back to the team.
There's two names for the same system?
There is "app bridge" https://shopify.dev/docs/api/app-bridge and now "app bridge library" https://shopify.dev/docs/api/app-bridge-library
Confusingly both pages use a description for the other instead of describing the context of itself. /api/app-bridge:
/api/app-bridge-library:
One is about the overall system? and the other seems like it would be about a ready made UI components reference the way it presents the reference like it's visual demo gallery of a component UI library though most are simplified calls/messaging for shopify-side rendering no "component" needed.
The /api/app-bridge-library/reference has read-only actions/endpoints mixed in the gallery-esque UI reference , some that are replacing previous javascript/react-hooks. Some of the old actions say you should used the new version but point to the /api/bridge-library page with no further info, such as appstate , or ones like the previous version resource-picker which just directs to shopify.dev because it points to dev.shopify.com instead of shopify.dev broken Link: https://dev.shopify.com/docs/api/app-bridge-library/reference/resource-picker , correct link https://shopify.dev/docs/api/app-bridge-library/reference/resource-picker
Navigation structure - clicking the reference link in the nav sidebar from /api/app-bridge goes to the /api/app-bridge-library docs which gets it's own empty navigation sidebar implying appbridge and app-bridge-library are separate systems, see image