add admin UX inspiration research doc

Competitor and platform analysis for UX patterns: Printify, Gelato,
Spring, Shopify, Stripe Connect, Pietra, WooCommerce. Includes key
patterns to adopt and current gaps.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/research/admin-ux-inspiration.md

@@ -0,0 +1,137 @@
+# Admin UX inspiration
+
+Research into platforms doing similar jobs to Berrypod — multi-provider POD storefronts, payment provider setup, onboarding wizards. Gathered Feb 2026.
+
+## Direct competitors (POD storefronts with provider management)
+
+### 1. Printify Pop-Up Store
+
+Printify's own built-in storefront — closest to what Berrypod does. Lets you sell without Shopify/Etsy. The setup flow is: connect account → browse catalog → design products → publish to your store. Worth studying their dashboard for how they handle product sync status, order routing, and the overall "getting started" flow.
+
+- Multi-provider model: 80+ print providers across 100+ locations on 4 continents
+- 900+ printable items
+- Tools: AI image generator, order routing, Shutterstock integration
+- Pop-Up Store link for selling without an external storefront
+
+Links:
+- https://printify.com/integrations/
+- https://printify.com/
+
+### 2. Gelato
+
+Global network of 140+ production hubs in 32 countries. Their admin dashboard handles intelligent order routing to the nearest facility, centralized order tracking, and multi-integration management. Their onboarding is praised as simple and well-guided.
+
+- Intelligent order routing to nearest facility (faster delivery, lower shipping, reduced carbon)
+- Centralized dashboard for order tracking across all production partners
+- Custom store via API or manual orders in dashboard
+- Easy-to-use interface frequently praised in reviews
+
+Good reference for how to present a multi-provider setup clearly.
+
+Links:
+- https://www.gelato.com/
+- https://www.gelato.com/integrations
+- https://bootstrappingecommerce.com/gelato-print-on-demand-review/
+
+### 3. Spring (formerly Teespring)
+
+Creator-focused POD platform with a clean dashboard. Good example of a simple, opinionated onboarding: sign up → upload design → create product → set up storefront.
+
+- "Storefronts" tab for store creation and customisation
+- At-a-glance metrics: total orders, units sold, profit, top-performing listings
+- "Messaging" feature for email marketing direct from dashboard
+- Clean, creator-first approach
+
+Links:
+- https://dashboard.teespring.com/
+- https://teespring.com/
+
+## Broader ecommerce admin UX worth stealing from
+
+### 4. Shopify Admin
+
+The gold standard for ecommerce admin UX. Their payment setup is essentially zero-config (Shopify Payments just works). For third-party providers, they use a clean card-based settings page. Their onboarding wizard is famously good — a checklist that guides you through store setup step by step. Our setup wizard is already similar in spirit.
+
+- Card-based settings pages
+- Checklist onboarding wizard
+- Zero-config payments where possible
+- Clean provider status indicators
+
+Links:
+- https://www.shopify.com/print-on-demand
+
+### 5. Stripe Connect Onboarding
+
+If we're looking at the Stripe setup specifically, Stripe's own embedded onboarding component is worth studying. They optimised it across thousands of platforms and saw a 5.3% conversion increase.
+
+Key UX wins:
+- Progress bar showing where you are in the process
+- Mobile-friendly large form fields
+- Real-time input validation, formatting, and error handling
+- Embedded flow that doesn't redirect away from the host app
+- Clean connection status display (connected/pending/action needed)
+- Built to WCAG standards: semantic HTML, keyboard nav, focus management
+- Dynamically updates for local requirements/regulations
+
+Links:
+- https://docs.stripe.com/connect/onboarding
+- https://stripe.com/blog/connect-express-onboarding
+- https://docs.stripe.com/connect/embedded-onboarding
+
+### 6. Pietra
+
+Handles sourcing, fulfilment, and storefront in one platform. Their onboarding guides new founders through setup with educational content alongside the setup steps. Good example of making a complex multi-provider setup feel approachable.
+
+- Access to 50,000+ global factories
+- AI-powered sourcing, quote comparison, supplier communication
+- Guided setup with educational manuals and videos for beginners
+- Team collaboration features
+
+Links:
+- https://www.pietrastudio.com/
+- https://help.pietrastudio.com/en/articles/8568025-how-can-i-use-pietra-to-launch-my-product-line-or-ecommerce-brand
+
+### 7. WooCommerce + Printful/Printify plugins
+
+Worth looking at how WooCommerce handles multiple POD plugins coexisting. Each plugin has its own settings page but orders appear unified. The WooCommerce setup wizard (for payment, shipping, store details) is a solid reference for progressive disclosure.
+
+- Printful praised for beginner-friendly UX with Design Maker and Mockup Generator
+- Printify offers more automation and flexibility through multi-supplier network
+- Unified order view despite separate provider plugins
+
+Links:
+- https://www.omnisend.com/blog/woocommerce-print-on-demand/
+- https://www.printful.com/integrations/woocommerce
+
+## Key UX patterns to nick
+
+| Pattern | From | Apply to |
+|---------|------|----------|
+| Card-based settings | Shopify | Provider and payment settings pages |
+| Checklist onboarding | Shopify | Setup wizard (already similar) |
+| Zero-config where possible | Shopify Payments | Reduce steps in Stripe setup |
+| Progress indicators | Stripe Connect | Setup wizard steps |
+| Inline validation | Stripe Connect | API key entry, provider connection |
+| Embedded flows (no redirect) | Stripe Connect | Keep everything in-app |
+| Status badges on provider cards | Gelato | Provider list page |
+| Order routing visibility | Gelato, Printify | Multi-provider order management |
+| At-a-glance metrics | Spring | Dashboard stats |
+| Educational content in onboarding | Pietra | Setup wizard help text |
+| Progressive disclosure | WooCommerce wizard | Settings pages |
+
+## What Berrypod already does well
+
+- Setup wizard with stepped onboarding (similar to Shopify checklist)
+- Provider cards with sync status indicators
+- Encrypted API key handling with masked hints
+- Test connection before saving
+- Dashboard with key metrics (orders, revenue, products)
+
+## Gaps to consider
+
+- No progress bar in setup wizard (Stripe Connect pattern)
+- Provider page could use richer status cards (Gelato style)
+- No inline validation on API key fields (Stripe pattern)
+- Could show estimated sync time or progress during product sync
+- Dashboard could surface more actionable info (top products, recent activity)
+- No educational/help content alongside setup steps (Pietra pattern)