Product patterns and adoption
This registry distinguishes native adapters, shared packages and product-specific workflows. Registration does not mean QO has changed its deployed dependencies.
| Pattern | Origin | Status | Contract |
|---|---|---|---|
| Reviewed batch import | CO | Product-specific composition | Review/Edit tabs separate the hierarchy from the searchable table. A staged, categorized side editor confirms changes explicitly and coordinates the support launcher. One import confirmation runs durable operations, separate access verification and result actions. Selling readiness is a separate optional step; uncertain writes stop the batch. |
| Page actions | QO / CO | Native Page adapter | Keep title/description left and page actions right. Native page heading supplies embedded chrome; an explicit body heading keeps the task title visible when Shopify moves its native heading into the app breadcrumb. |
| Compact onboarding guide | QO | Registered; QO implementation retained | Incomplete guides collapse; only a completed guide can be dismissed after confirmation. |
| Resource columns & view toolbar | QO | Registered; ResourceToolbar available | Compact All control, flexible search, explicit sort and column controls. |
| Buyer choice row | QO | Registered; product-specific adapter | Left-aligned label and icon. Native purchasing roles remain authoritative. |
| Linked translation preview | QO | Hidden; not a review-release component | Sticky code preview and bidirectional field focus; preserve unfinished work. |
| File and attachment drop zones | QO / CO | Native s-drop-zone adapter | MIME/extension filters plus server size/type validation. SDK attachments remain owned by Harbor. |
| Settings navigation | QO / CO | Shared SettingsLayout available; CO adopted | Anchored sections, sticky desktop navigation, native settings controls. |
| Brand footer | QO / CO | Shared BrandFooter available; CO adopted | Clickable public Kaupvik attribution; no change to QO review deployment. |
| Support dock | Harbor / QO / CO | Harbor Support SDK v1 | Central UI, plus-menu uploads, history, full-height messages and animated dock. Authenticated product transport remains separate. |
| Company relationship map | CO | Shared RelationshipGraph; CO adapter | Deduplicate native customers, label roles and partial pages, keep tree alternative. Hand/select tools, Shift multi-selection and group layout undo never write business data. |
| Visual customer filters | CO | Shared FilterBuilder; CO query adapter | Bounded nested AND/OR/NOT/exactly-one expressions, per-value suggestions, allowlisted fields and explicit native scan coverage. |
| Bulk name change preview | CO | Product-specific business composition | Native modal before/after review, version confirmation, per-step execution and reconciliation. Organization edits and saved history open the same modal; profile deletion preserves companies, other tags and logos. Never a generic graph mutation. |
Adding a business component
Prefer an official Polaris component first. For a missing composition, document its state model, controlled properties, keyboard/focus behavior, responsive rules, tokens and transport boundary. Add source, declarations, an interactive example, tests and a changelog. Pack a new immutable version and validate it in one product before other products adopt it.
Harbor integration
Harbor owns the Support SDK and its UI. Products supply authenticated transport, a signed server connector, product name/icon, route and diagnostic summary. A public bundle or product key grants no access. Register a distinct key and secret per environment; never forward Shopify tokens to Harbor.