Three surfaces.
One voice.
Marketing landing site, embedded Shopify admin app, and the storefront widget. Each has its own conventions, but all three share the same tokens, the same wordmark, the same accent rules.
The Refusal. The canonical brand surface.
Stealth one-pager + Journal. Anti-SaaS, editorial, paper-on-ink. Converts a small set of high-fit Shopify merchants into cohort applications. Never names the mechanism.
A quiet, dense operator app.
Polaris layout (sidebar + main, 200px nav). BetterReviews tokens on top: paper, hairlines, brand mark.
Cards 6px radius, buttons pill. Body in Fraunces opsz 9 to read like prose, not chat.
No Shopify green. No success toast confetti. No emoji in product copy. Ever.
Auto-match the merchant's brand. Disappear.
"Smells like rosemary, not perfume. Sensitive skin loved it."
Eleanor M. · Verified buyer · 14 May
The widget brief
The widget is the one BetterReviews surface that is not BetterReviews-branded. It scans the merchant's storefront on install · picks up their type stack, their button radii, their accent · and renders the review block inside that vocabulary. Liquid + CSS, no React.
Rules
- Inherits the merchant's
--font-body,--color-accent, button radii - Renders to the merchant's Schema.org Review markup for SEO
- One review block per product page; never a sidebar widget, never a popover
- The only "BetterReviews" mark is a hairline footer link, opt-in
- Loads in < 18KB CSS, zero JS for above-the-fold render
Why this matters
Reviews are first-party language. They earn citation in answer engines by reading like the merchant's voice, not like a SaaS chrome layer.
What carries across, what doesn't.
- Paper-on-ink + ink-on-paper
- Sharp corners (--r-sharp)
- Hairline everywhere, shadow rare
- Editorial chrome, Roman numerals
- Magritte frame, peacock drenched band
- Full wordmark, accent dots
- Paper only (no ink mode)
- --r-md cards · --r-pill buttons
- Resting --sh-card on data cards
- Tabular numerals everywhere
- Polaris layout, BetterReviews chrome
- Single-line wordmark in top bar
- Inherits merchant theme tokens
- Adopts merchant's accent
- Adopts merchant's font stack
- Hairline review block only
- Schema.org markup
- Footer "powered by" hairline link · opt-in