Curate Algolia search results with live Shopify stock

Build me a search merchandising control room, an app I open every morning to curate what shoppers see. It sits on top of my Algolia index and my Shopify catalog. I am the merchandiser doing this in real time, so the app is an interactive curation surface, not a scheduled job.

Main screen. At the top, an index picker populated with Algolia List Indices, remembering whichever index I used last. Below it, a query bar where I type a real customer search term. Run Algolia Search Single Index against the selected index with that exact query and render the hits in their true ranked order, numbered by position, exactly as a shopper would receive them. No client-side re-sorting, the whole value here is seeing the real ranking.

Enrich every result card with live Shopify data. Match an Algolia record to Shopify by SKU when the record has one, otherwise treat the objectID as a Shopify product or variant id. Use Shopify List Products for the product record (title, vendor, status, published state, image), Get Variant for price and variant SKU, Get Inventory Item to resolve a variant's inventory item id, and List Inventory Levels for available stock across locations. Show current stock, price, and vendor on each card. Batch these lookups rather than firing one request per card. Some indices hold non-product content, so when a record has no Shopify match, still render the card in its correct ranked position, labelled as having no catalog match, and never let a missing match break the row or the page.

Curation. Let me drag a product card to a position to pin it there, or push a product down to bury it. Hold the edited order as an unsaved draft. Show a clear before and after of the result order, the default Algolia ranking beside my edited ranking, with move indicators on the products that shifted, so I can see the impact of my change before saving anything.

Saving writes a real Algolia query rule for that search term using Save Rule, with the pinned products as promoted records at their chosen positions and buried products as hidden or demoted consequences, and the rule condition anchored on the search term I typed. Show me exactly what will be written and make me confirm before it goes live.

Side panel. Use Algolia Search Rules to list the rules already active on the selected index, each with its trigger term and its promoted products, so I can see what is currently pinned across the whole index. Clicking a rule loads it into the main canvas for editing, and its promoted products get the same Shopify enrichment as search results.

The most important nuance is stock and promo awareness, which merchandisers say is missing from normal pinning tools. Any already-pinned product that is now out of stock, archived, or unpublished in Shopify gets a loud warning badge, plus a one-click unpin that rewrites the rule without that product. Surface a running count of at-risk pins across the index somewhere prominent, so I can catch problems without opening every rule one by one.

Also show a read-only context strip from Algolia Get Settings for the selected index, listing the searchable attributes and the custom ranking attributes, so I understand why the default order looks the way it does before I start overriding it.

This needs an Algolia Admin API key because saving rules is a write. If the connected key is read-only, degrade gracefully into a browse-only mode with saving disabled and a clear explanation, rather than failing on save.