Skip to content

feat(admin): add How to Use guide tab and storefront portal onboarding card - #27

Merged
arsalan-arshad merged 2 commits into
mainfrom
feat/admin-usage-guide-tab
Nov 8, 2026
Merged

arsalan-arshad merged 2 commits into
mainfrom
feat/admin-usage-guide-tab

Conversation

@arsalan-arshad

Copy link
Copy Markdown
Owner

Summary

Adds a dedicated "How to Use" guide tab (?tab=guide) and an onboarding callout card on the default "Practitioners" tab in the embedded Shopify Admin dashboard.

Changes

  1. How to Use Tab (?tab=guide):
    • Storefront Practitioner Portal Link: Displays https://${shop}/apps/protocols with one-click clipboard copy (.copy-portal-btn) and fallback support.
    • Part 1 — Storefront Menu Setup: Step-by-step guidance showing merchants how to add /apps/protocols under Shopify Admin -> Online Store -> Navigation (/admin/menus).
    • The 3 User Roles: Clear breakdown of Merchant (Store Owner), Practitioner (Provider), and Client (Shopper).
    • Part 2 — Complete Step-by-Step Walkthrough across 4 Acts:
      • Act 1: The Store Owner (Shopify Admin Setup & Starters)
      • Act 2: The Practitioner (Storefront Portal, approvals, protocol authoring, and PDF handouts with QR codes)
      • Act 3: The Shopper (1-click Add All to Cart & checkout)
      • Act 4: Sales Attribution & Reports (Real-time attribution & RFC 4180 CSV exports)
    • FAQ: Common questions regarding staff accounts, stock status, commissions, and identity modes.
  2. Onboarding Banner on Practitioners Tab:
    • Welcome card at the top of the Practitioners tab displaying the storefront portal link, copy button, and link to the guide tab.
  3. App Bridge Token & Session Integrity:
    • In-app tab links (a.Polaris-Tab, a.Polaris-Tab-Link) automatically preserve shop, host, embedded, and App Bridge id_token.
    • Zero-PII barrier and escape functions preserved.
  4. Automated Unit Tests:
    • Added unit tests in test/admin.test.js validating the guide tab, navigation link, 4-act journey assertions, and onboarding card.
    • 584 unit tests passing across 132 suites (npm test).

@arsalan-arshad
arsalan-arshad merged commit 133bdb1 into main Nov 8, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant