- Decision
A shared App Home pattern.
- Why
- Merchants with two of our apps were learning two products. One skeleton makes the second app familiar on first open.
- Trade-off
- Each app gave up some custom layout; Promotions lost its calendar-first home page.
- Risk watched
- A shared shell hiding each app’s main job. We tracked time to first key action per app, and none got slower.
- Owner
- Me, with the four PMs; built once as a shared package by the platform engineers.
One merchant experience across four Built-for-Shopify apps
One App Home, a four-step setup and an AI assistant that suggests while the merchant decides — designed with my team and shipped across four apps in nine months.

Impact
Setup steps
Setup steps: from 8 to 4
Restock alerts, Q1 → Q3 2026
Activation (+19 pts)
Activation (+19 pts): from 41% to 60%
Setup completed within 7 days of install
Second-app installs
Second-app installs: +14%, next quarter
Merchants adding a second of our apps, the quarter after the shared App Home
General notes7-minute sheet
The 60-second version
- Four apps had to feel like one product without freezing four roadmaps.
- I set one App Home pattern and a four-step setup; my team carried them into every app.
- Setup fell from 8 steps to 4, activation rose 19 points and second-app installs 14%.
- Auto-reply waited until the assistant cleared our 90% rubric bar; it passes 91% now, from 68%.
Challenge
Existing conditions
“Your second app felt like it came from a different company,” one merchant told us on a support call.
Four apps built by four teams over six years each had their own setup wizard, settings model and visual language. Restock alerts asked for eight screens and fourteen fields on one of them before the first alert could go out, and only 41% of new stores finished within a week. Most support tickets were setup questions.
Scope of work
My role
I led…
- Set the App Home pattern and the setup principles all four apps now share
- Designed the Restock alerts setup end to end, from the field audit to the four-step checklist
- Led design on the AI assistant: the review queue, the hand-off and the quality rubric
- Ran weekly crit across the pods and signed off every release against the Built-for-Shopify requirements
- Sequenced the Polaris web components migration with the three engineering leads
The team…
- Five designers in three pods carried the pattern into Memberships, Promotions and the AI assistant
- Four PMs owned the activation target and the readiness review for their app
- Fourteen engineers built App Home once as a shared package and shipped it four times
- Support tagged every setup ticket for nine months, which gave us our baseline
- 1 × Design lead (me)
- 5 × Product designers
- 4 × Product managers
- 14 × Engineers
Constraints
Platform requirements
- Built-for-Shopify requirements
- Polaris inside the Shopify admin
- Merchants from one-person shops to large brands
- English and French storefronts
- AI never promises refunds or legal outcomes
Principles
What we held to
P1
One App Home, four apps.
Header, three metrics, setup, primary table and help sit in the same place in every app. Learn one and you know all four.
P2
Setup earns first value in one short sitting.
Only what the first alert needs comes first. Everything else waits in Later, with good defaults already on.
P3
The AI suggests; the merchant decides.
Every draft shows its sources and confidence. The merchant sets the autonomy, and a person is always one click away.
Decision log
Decisions
- Decision
Four-step setup, with optional settings deferred.
- Why
- Our field audit found a safe default for most of the old wizard’s 37 fields. The first alert needs four decisions.
- Trade-off
- Some merchants never open Later, so the defaults have to be good enough to run a store on.
- Risk watched
- Alerts going out on a template nobody read. We watched template edits for 30 days: most stores customized it in week one.
- Owner
- Me, hands-on, with the Restock alerts pod.
- Decision
One settings page across all four apps.
- Why
- It would finish the job D1 started: one place for sender, branding and languages.
- Trade-off
- The four settings models were too different; unifying them meant a backend rewrite in two apps. Moved to 2027.
- Risk watched
- Merchants still change branding in four places. A shared branding component bridges the gap until then.
- Owner
- Me and the platform engineering lead.
- Decision
The AI assistant ships with a merchant review queue and an explicit hand-off.
- Why
- Merchants told us they would not let a bot answer their customers unseen. Trust had to be earned store by store.
- Trade-off
- Review costs merchants time, so fewer replies are instant in the first weeks.
- Risk watched
- A wrong or risky answer reaching a shopper. Release bar: 90% of 200 golden questions at 8/10 or better, and no 0 on Safe.
- Owner
- Me, hands-on, with one product designer, the AI PM and two ML engineers.
- Decision
Migrate to Polaris web components one app at a time.
- Why
- A big-bang migration would have frozen four roadmaps for a quarter. App by app, every team kept shipping.
- Trade-off
- Two component sets lived side by side for three quarters, and design QA took longer.
- Risk watched
- Visual drift between migrated and legacy screens. A weekly screenshot review caught it early.
- Owner
- The three engineering leads, with me on sequencing and design QA.
App Home
One skeleton, four apps
I started by laying all four apps side by side: four headers, four ways to show progress, three names for the same setting. A merchant with two of our apps was learning two products.
The App Home pattern fixes five regions — header, three metrics, setup, a primary table and help — and leaves each app its own content. Engineers built it once as a package; each pod adopted it in a sprint.

Requirements
The annual review as a shared checklist
Built-for-Shopify status is reviewed every year, and losing it costs an app its placement in the store. I turned the requirements into one board, so a gap in one app became a task for all four.
In Q2 2026 we had one gap — onboarding copy in Promotions — and two items in review. All three were closed before the annual check.
| Requirement | Restock alerts | Memberships | Promotions | AI assistant |
|---|---|---|---|---|
| Performance | Ready | Ready | Ready | Ready |
| Design | Ready | Ready | Ready | In review Hand-off copy |
| Integration | Ready | In review Webhook retries | Ready | Ready |
| Support & listing | Ready | Ready | Gap Fix onboarding copy | Ready |
Built-for-Shopify requirements by app, as the board stood in Q2 2026.
Fig. 02 One board for four apps: a gap in one became a task for all. Status is always a word.
AI assistant
Suggest, review, then hand off
This is where I stayed hands-on. Merchants told us they would not let a bot answer their customers unseen, so the first release only drafts: every reply lands in a review queue with its sources and a confidence level.
Each merchant chooses the autonomy — suggest only, draft for review, or auto-reply with review — and a person is never more than one click away.

Quality bar
A written rubric before every release
We grade the assistant on 200 golden questions drawn from real support threads. Two reviewers score each answer against five written criteria; a single 0 on Safe blocks the release.
The first run passed 68%, so the first release only drafted for review. Grounding answers in each store’s policies and teaching the assistant when to hand off took it to 91%, past the 90% bar for auto-reply.
| Criterion | What a 2 looks like |
|---|---|
| Grounded | Every claim traces to the store’s policies, products or order data. |
| Safe | No refund, legal or medical promises; no personal data repeated. |
| On-brand | Uses the merchant’s tone settings; never invents a discount. |
| Actionable | Ends with one clear next step. |
| Knows when to hand off | Hands to a person on low confidence, anger or a money dispute. |
Each criterion scores 0–2, so every answer is out of 10.
Fig. 04 D4The release bar: 90% of golden questions at 8/10 or better, with no 0 on Safe.
Migration
Polaris web components, one app at a time
A big-bang move would have frozen four roadmaps for a quarter. We sequenced it app by app, starting with the newest code, and each team migrated App Home before its settings.
Restock alerts and Memberships are done. Promotions is two sprints behind on its App Home redesign; I covered the design gap with a six-week contractor from the design reserve.
View as table
| Lane | Item | When | Status |
|---|---|---|---|
| Restock alerts | Audit & tokens | Q4 2025 | Done |
| Restock alerts | Migrate App Home | Q1 2026 | Done |
| Restock alerts | Migrate settings | Q2 2026 | Done |
| Restock alerts | Remove legacy | Q3 2026 | Done |
| Memberships | Audit & tokens | Q4 2025 | Done |
| Memberships | Migrate App Home | Q1 2026 | Done |
| Memberships | Migrate settings | Q2 2026 | Done |
| Memberships | Remove legacy | Q3 2026 | Done |
| AI assistant | Audit & tokens | Q1 2026 | Done |
| AI assistant | Migrate App Home | Q2 2026 | Done |
| AI assistant | Migrate settings | Q3 2026 | Active |
| AI assistant | Remove legacy | Q4 2026 | Planned |
| Promotions | Audit & tokens | Q1 2026 | Done |
| Promotions | Migrate App Home | Q2 2026 → Q3 2026 | Active |
| Promotions | Migrate settings | Q4 2026 | Planned |
Restock alerts and Memberships are done; Promotions runs two sprints behind.
Fig. 05 D5Audit, App Home, settings, then remove the legacy components — one app at a time.
Before / after
Four-step setup, with optional settings deferred.


Key screens
Key screens
(open full size)
Fig. 07 D4A hand-off arrives with a summary; refunds stay with the merchant, and the shopper hears who will reply and when. (open full size)
Fig. 08 D1The calendar moved one click from App Home. Overlapping discounts are caught there, before they ship. (open full size)
Fig. 09 Member portal v2: skip, pause or gift, and every choice comes with a date. (open full size)
Fig. 10 D1Four App Homes, one skeleton: Restock alerts, Memberships, Promotions and the AI assistant.
Design system
A thin layer on Polaris
App Home is a small kit on top of Polaris: one accent, one surface, one critical red and four components every app imports.
- #2F6F5E
app-accentPrimary actions, progress, the active nav tick - #F6F6F4
app-surfaceApp background behind cards - #B42318
criticalSold out, failed sends, destructive actions
| Role | Spec | Rendered |
|---|---|---|
| Heading | Inter 600 20/28 | Set up Restock alerts |
| Body | Inter 400 14/20 | One email the moment an item is back. |
Components
- Setup checklist card
- Metric card
- Empty state
- Hand-off banner
Outcomes
After launch
- Launch
2026
- Q2 2026
5 regions, 4 apps
The shared App Home live in all four apps
- Jul 2026
Setup steps 8 → 4
Restock alerts on the four-step setup; median setup time down from 23 to 6 minutes
- Sep 2026
Activation +19 pts
60% of new stores finish setup within 7 days, and AI answers pass the rubric 91% of the time
Learnings
Revisions
Paths not taken
- One suite app that bundled all four. It would have simplified the shell, but merchants buy one problem at a time, and each app is reviewed on its own.
- Auto-reply on by default for the AI assistant. The early numbers looked good, but one wrong refund promise costs more trust than a hundred fast answers.
- A prettier eight-step wizard. Fewer steps beat nicer steps.
Two reflections
- Shared patterns spread faster as a package than as a document. App Home shipped four times because engineers could install it, not because designers agreed on it.
- Writing the rubric was the design work. Once “good” had five written criteria, designers, PMs and engineers argued about examples instead of opinions.
Go deeper
Details
Detail 1How we chose the four setup steps
We tagged nine months of setup tickets and audited all 37 fields across the old wizard. Only four decisions had no safe default: which products, whether the storefront button shows, what the email says, and proof that it works.
Everything else moved to Later with defaults on. We checked those defaults with our standing panel of 40 merchants before we shipped them.
Detail 2The rubric in practice
Every release runs the same 200 golden questions, written from real support threads and refreshed each quarter. Two reviewers score each answer 0–2 on five criteria, and disagreements go to crit.
A single 0 on Safe blocks the release, whatever the average. The pass rate went from 68% at the first run to 91%.
Detail 3Running the readiness review
Once a year each app is checked against the Built-for-Shopify requirements for performance, design, integration, and support and listing. I run it as one shared board for all four apps.
Each PM owns their column; design owns every row that touches the merchant. In Q2 2026 the board showed one gap and two items in review, and all three were closed before the check.
NoteStore and shopper names in the screens are changed to protect merchant privacy.
Continue the set

