jirazolabsPlush Scout · Design artifactHow we designed it →
The 3 prompts behind this pageAll prompts →
  1. Prompt 01Components

    Can we now create a list of components, both on web and app, that we will need? We can have an Expo app btw, so that we can serve all 3 at the same time.

    For components let's follow:

    • component.web.tsx
    • component.tsx [for native mobile ones]
  2. Prompt 02The table

    Just create a list right now: a table of what we need and what it does, and then a list of APIs we will need for all the screens.

  3. Prompt 03Screens

    Also for each screen check components. I mean, for each screen, which components are used.

Plush Scout · build spec · draft 3 Oct 2026

Components and screens

What we need to build one Expo app that serves iOS, Android and the web from the same code. It covers every component (and whether it needs a separate web file), which components each screen uses, and the API each screen calls. Drawn from the iOS design explorer, the Liquid Glass sets and the web app designs.

72components
20split into .tsx + .web.tsx
49shared, one file
17screens
47API endpoints

How files are organised

  • Name.tsx is the iOS and Android version; Name.web.tsx is the web version. Metro picks the .web.tsx file on the web and .tsx everywhere else (.ios.tsx or .android.tsx if one platform ever needs its own).
  • Shared components have only Name.tsx; react-native-web renders them in the browser.
  • Components for one platform still ship a stub for the other (returns null or a fallback), so every import resolves on all three.
  • Screens live once in app/ (Expo Router) and pick up the right platform components automatically. Colours and type come from the shared 15-theme tokens.
  • On iOS, Liquid Glass stays on the tab bar and floating buttons; content is solid. No screen shows how often we check prices or stock.
SplitSharediOS/Android onlyWeb only
app/                  routes for iOS, Android and web
  (tabs)/             Home, Shelf, Alerts, Me
  plush/[slug]/[size]/  plush page, listings
  shops/  alerts/  check/  pro.tsx
  (auth)/  u/[handle].tsx
components/
  shell/  plush/  prices/  listings/
  shelf/  alerts/  shops/  check/  account/
lib/api/              typed client + query hooks
theme/                15 themes, light and dark

Components

Each row says what the component does, how the iOS/Android and web versions differ, and which screens use it.

ComponentFilesWhat it doesiOS / AndroidWebUsed on
App shell
AppTabs
Split
AppTabs.tsxAppTabs.web.tsxMain navigation between Home, Shelf, Alerts and Me.Expo Router native tabs: the iOS 26 Liquid Glass tab bar, Material bottom bar on Android.Left sidebar with the same sections plus Catalogue, Prices and Shops.All tab screens
CheckButton
Split
CheckButton.tsxCheckButton.web.tsxStarts the Check a plush flow from anywhere.Separate glass circle at the right end of the tab bar on iOS; floating button on Android.Primary button in the sidebar.All tab screens
ScreenHeader
Split
ScreenHeader.tsxScreenHeader.web.tsxPage title, back and page actions.Large title, glass back button and glass action group floating over content.Breadcrumbs, page title and a button row.S1, S4, S5, S7, S8, S9, S12, S13, S14, S15
TopBar
Web only
TopBar.web.tsxTopBar.tsx · stubGlobal search, market switch, notifications and account menu across the top.Stub (native uses ScreenHeader and the tab bar).Search field with ⌘K, market pill, bell with unread dot, avatar menu.S1, S2, S3, S4, S5, S6, S7, S8, S9, S11, S12, S14
IconButton
Split
IconButton.tsxIconButton.web.tsxRound or capsule icon button.Glass on iOS 26 (expo-glass-effect), tonal fallback on Android.Standard button with hover and focus states.S7
SearchField
Split
SearchField.tsxSearchField.web.tsxSearch plush, tag codes and shops with suggestions.Search screen opened from the tab bar, with recent searches.Field in the top bar; opens CommandPalette.S1, S6, S11
CommandPalette
Web only
CommandPalette.web.tsxCommandPalette.tsx · stubKeyboard quick search and actions (⌘K).Stub.Modal list of plush, shops and actions.S1, S6
Sheet
Split
Sheet.tsxSheet.web.tsxContainer for secondary tasks: add to shelf, alerts, filters, shop list.Bottom sheet with detents (Expo Router formSheet).Right-hand drawer, or a centred modal for short tasks.S2, S3, S4, S7, S9, S10, S11, S13, S15
ThemeProvider
Shared
ThemeProvider.tsxSupplies the 15 themes in light and dark as tokens and follows system appearance.——Every screen (app root)
Toast
Shared
Toast.tsxShort confirmations such as "Alert created".——S15
EmptyState
Shared
EmptyState.tsxFriendly empty and error screens with the Peekaboo mascot.——S1, S2, S6, S9, S16
Skeleton
Shared
Skeleton.tsxLoading placeholders shaped like the content.——S1, S6
Plush
PlushImage
Shared
PlushImage.tsxPlush photo on a tinted tile, resized by Cloudflare for each screen size.expo-image with caching.Same component; lazy loads below the fold.S4, S7
PlushCard
Shared
PlushCard.tsxGrid tile: photo, status, size tag, value and price paid.——S1, S2, S6, S17
PlushRow
Shared
PlushRow.tsxCompact row: thumbnail, name, size, price or change.——S1, S3, S12
StatusPill
Shared
StatusPill.tsxIn production, out of stock, retiring, retired or likely retired.——S1, S2, S3, S4, S6, S7
SizeSelector
Shared
SizeSelector.tsxSizes with height and status; sold-out sizes crossed out.——S7, S10
TagDetails
Shared
TagDetails.tsxTag code, height, UK and US RRP, released and retired dates.——S7
RetiredSeal
Shared
RetiredSeal.tsxRound "Retired Jan 26" badge on the plush image.——S7
DemandBar
Shared
DemandBar.tsxHow many collectors own it versus want it.——S7
Prices
PriceVerdict
Shared
PriceVerdict.tsx"From £34" with a good, fair or high badge and the low-to-high range.——S7
RangeBar
Shared
RangeBar.tsxLow, typical and high asking prices with today's lowest marked.react-native-svg.Same SVG.S7
PriceChart
Split
PriceChart.tsxPriceChart.web.tsxMedian asking price over time, sold prices as dots, retirement marker.Drag to scrub (Reanimated and gesture handler).Hover crosshair with tooltip.S7
PriceHistogram
Shared
PriceHistogram.tsxSpread of current asking prices with RRP, median and an optional alert threshold.Threshold handle drags.Threshold handle drags or clicks.S7, S8, S10
Sparkline
Shared
Sparkline.tsxSmall trend line for collection value and the watchlist.——S1, S3
ChangePill
Shared
ChangePill.tsx+8.1%, −12.5% or RRP, coloured by direction.——S1, S3
StatTile
Shared
StatTile.tsxLabel, large value and change, e.g. "Estimated value £2,140".——S2, S5, S8
RangeChips
Shared
RangeChips.tsx1M, 3M, 1Y and All switch for charts.——S7
Listings
ListingList
Split
ListingList.tsxListingList.web.tsxEvery listing for one size of a plush.Virtualised rows (FlashList).Sortable table with columns and sticky header.S8
WhereToBuy
Shared
WhereToBuy.tsxBest few offers (best new price, cheapest resale) with "See all".——S4, S7, S17
SourceBadge
Shared
SourceBadge.tsxShop or marketplace mark (initials or logo).——S7, S8
StockBadge
Shared
StockBadge.tsxIn stock, 2 left, low stock, sold out or shop only.——S7, S8, S11, S12
FilterBar
Split
FilterBar.tsxFilterBar.web.tsxFilters for condition, region, source, price and sort.Scrolling chips plus a Filters sheet.One row of dropdown pills plus an All filters drawer.S2, S4, S6, S8, S10, S11
SalesList
Shared
SalesList.tsxRecent sold prices with date, source and condition.——S7
AffiliateDisclosure
Shared
AffiliateDisclosure.tsxeBay Partner Network notice wherever buying links appear.——S7, S8
OutboundLink
Split
OutboundLink.tsxOutboundLink.web.tsxOpens a listing through our tracked redirect.In-app browser (expo-web-browser), or the eBay app when installed.New tab.S7, S8
Shelf
ShelfHeader
Shared
ShelfHeader.tsxOwned and Wanted switch, totals, share and export actions.——S2, S3
CollectionList
Split
CollectionList.tsxCollectionList.web.tsxYour named shelves (Bashful bunnies, Retired gems…).Big picture cards.Collections and filters down the left of the shelf.S2
ShelfGrid
Shared
ShelfGrid.tsxResponsive grid of PlushCards: 2 across on phones, 5 on desktop.——S2, S6, S17
ValueCard
Shared
ValueCard.tsxEstimated collection value, 30-day change and sparkline.——S1, S2
SetCompletion
Shared
SetCompletion.tsxProgress ring and owned versus missing slots for a design line.——S4
MilestoneMedal
Shared
MilestoneMedal.tsxHolographic medal with progress toward the next one.——S5, S14
AddToShelfForm
Shared
AddToShelfForm.tsxCondition, tags on or off, price paid, date, shop and photos.——S2, S7, S13
PhotoPicker
Shared
PhotoPicker.tsxTake or choose photos and upload them to R2 with a signed URL.expo-image-picker with camera.expo-image-picker file input.S2, S13
ShareCard
Split
ShareCard.tsxShareCard.web.tsxShareable wanted (ISO) list or shelf card.Render to image (react-native-view-shot) and open the share sheet.Server-made image plus copy link or Web Share.S2, S3, S17
Alerts
AlertList
Split
AlertList.tsxAlertList.web.tsxYour alerts with on and off switches and last match.Rows with switches.Table with columns.S9
AlertForm
Shared
AlertForm.tsxAlert type, size, target price, live match preview, conditions, sources and channels.Shown in a Sheet.Shown in a drawer, or inline on the plush page.S3, S7, S9, S10
PriceInput
Shared
PriceInput.tsxCurrency field showing the current lowest price beside it.Numeric keypad.—S7, S10
MatchFeed
Shared
MatchFeed.tsxAlerts that fired: what, where, price and when.——S1, S9
QuotaMeter
Shared
QuotaMeter.tsxFree plan usage (3 of 3 alerts, 1 of 3 checks) with a Try Pro link; hidden on Pro.——S3, S9, S14
RestockRadarCard
Shared
RestockRadarCard.tsxTonight's drop window and how many of your wants are being watched.——S1
PushPrompt
iOS/Android only
PushPrompt.tsxPushPrompt.web.tsx · stubAsks for notification permission with the mascot.expo-notifications.Stub (web push can come later).S10, S16
Shops
StoreMap
Split
StoreMap.tsxStoreMap.web.tsxMap of shops near you.Apple Maps on iOS, Google Maps on Android (react-native-maps or expo-maps).MapLibre GL JS with hosted tiles.S11, S12
PricePin
Split
PricePin.tsxPricePin.web.tsxMap marker showing price, initials or a grey "no stock" state.Custom marker view.HTML marker.S11
MapControls
Split
MapControls.tsxMapControls.web.tsxLocate me, zoom and layers.Glass button stack on iOS.Zoom buttons and locate.S11
StoreList
Shared
StoreList.tsxShops sorted by distance with stock, price and opening hours.Inside a Sheet over the map.Column beside the map.S11
StoreCard
Shared
StoreCard.tsxOne shop: hours, distance, stock for your wants and actions.——S12
StoreActions
Shared
StoreActions.tsxDirections, website and call.Opens Apple or Google Maps and the dialler.Opens maps and the site in new tabs; shows the phone number as text.S12
HoursTable
Shared
HoursTable.tsxOpening hours with today highlighted.——S12
StockNote
Shared
StockNote.tsx"Stock can change quickly, so call ahead" notice.——S11, S12
Check a plush
TagScanner
Split
TagScanner.tsxTagScanner.web.tsxReads the tag's barcode or QR code to identify the plush.Live camera scan (expo-camera).Upload a photo of the tag or type the code.S13
CodeLookup
Shared
CodeLookup.tsxType a tag code, SKU or barcode with suggestions.——S13
ChecklistStep
Shared
ChecklistStep.tsxOne authenticity check with real and fake photo examples; yes, no or not sure.——S13
ConfidenceResult
Shared
ConfidenceResult.tsxConfidence meter and verdict, worded as a guide, not a guarantee.——S13
EvidencePdfButton
Shared
EvidencePdfButton.tsxMakes the dispute evidence PDF on the server, then opens or shares it.Share sheet.Download link.S13
Account
SignInButtons
Split
SignInButtons.tsxSignInButtons.web.tsxSign in and account creation.Sign in with Apple, Google and email (expo-apple-authentication).Supabase OAuth redirect and email magic link.S16
Paywall
Split
Paywall.tsxPaywall.web.tsxPro plans: yearly (picked by default), monthly and weekly, all with 7 days free, and lifetime as a one-off. Turns into plan management once paid.In-app purchase through RevenueCat; Restore purchases.Stripe Checkout; Stripe's billing page for changes.S13, S15
ProGate
Shared
ProGate.tsxLocks a Pro section on Free: blurs it and shows a "Try Pro" chip that opens the paywall.——S1, S2, S7
PlanStatus
Shared
PlanStatus.tsxShows the plan: free usage, trial days left, or Pro renewal date.Banner on Home and cards on Alerts.Sidebar plan card and Home banner.S1, S9, S15
PlanCompare
Split
PlanCompare.tsxPlanCompare.web.tsxFree and Pro side by side, grouped by area, with a "Your plan" tag on the current column. Rows and limits come from the server.A tall Sheet opened from "Compare Free and Pro" on the paywall.A table under the plan cards on /pro.S15
MarketSwitcher
Shared
MarketSwitcher.tsxUK or US prices and currency.——S14, S16
SettingsList
Shared
SettingsList.tsxNotifications, theme, market, export and account settings.——S14

Screens and the components each uses

Grey chips render on every platform. Purple chips are iOS/Android versions, blue chips are web versions. Push notifications are a system surface outside the screen list.

#ScreenComponents on every platformiOS / AndroidWebAPIs
S1Home
/ (tabs)/index
iOS 1 · glass A/B · web W1
ScreenHeaderPlanStatusMatchFeedPlushCardPlushRowChangePillStatusPillValueCardProGateSparklineRestockRadarCardEmptyStateSkeleton
AppTabs (glass tab bar)CheckButton (tab bar)SearchField (search screen)
AppTabs (sidebar)CheckButton (sidebar)TopBarCommandPalette
me, feed-matches, collection-summary, radar, feed-retired, wants-drops
S2My shelf
/shelf
iOS 2 · glass A1 · web W2
ShelfHeaderStatTileValueCardProGateFilterBarCollectionListShelfGridPlushCardStatusPillShareCardSheetAddToShelfFormPhotoPickerEmptyState
CollectionList (picture cards)FilterBar (chips + sheet)
CollectionList (sidebar)FilterBar (pills)TopBar
collection-list, collection-summary, collections, collection-add, collection-edit, uploads-sign, export, iso-card
S3Wanted (watchlist)
/shelf?view=wanted
glass B1
ShelfHeaderPlushRowSparklineChangePillStatusPillQuotaMeterSheetAlertFormShareCard
—
TopBar
wants-list, wants-add, wants-remove, alerts-create, iso-card
S4Complete the set
/shelf/sets/[line]
glass A2
ScreenHeaderSetCompletionFilterBarPlushImageStatusPillSheetWhereToBuy
—
TopBar
sets-detail, where-to-buy
S5Milestones
/me/milestones
glass A3
ScreenHeaderMilestoneMedalStatTile
—
TopBar
milestones
S6Catalogue and search
/catalogue · /search?q=
not designed yet
SearchFieldFilterBarShelfGridPlushCardStatusPillEmptyStateSkeleton
—
TopBarCommandPalette
catalogue-search, search-suggest, feed-retired
S7Plush page
/plush/[slug]/[size]
iOS 3–4 · glass A4 · web W3
ScreenHeaderIconButtonPlushImageRetiredSealStatusPillSizeSelectorTagDetailsPriceVerdictRangeBarPriceChartRangeChipsProGateWhereToBuySourceBadgeStockBadgeSalesListDemandBarAffiliateDisclosureOutboundLinkAlertFormPriceInputPriceHistogramSheetAddToShelfForm
AlertForm in a SheetPriceChart (scrub)
AlertForm inline in the right panelPriceChart (hover)TopBar
plush, variant-market, price-history, listings, sales, where-to-buy, histogram, alerts-create, collection-add, wants-add, out
S8Every listing
/plush/[slug]/[size]/listings
iOS 5 · web W4
ScreenHeaderFilterBarPriceHistogramStatTileListingListSourceBadgeStockBadgeOutboundLinkAffiliateDisclosure
ListingList (rows)
ListingList (table)TopBar
listings, histogram, out, alerts-create
S9Alerts
/alerts
iOS 6 · glass B3 · web W5
ScreenHeaderAlertListQuotaMeterPlanStatusMatchFeedEmptyStateSheetAlertForm
AlertList (rows)
AlertList (table)TopBar
alerts-list, alerts-edit, alerts-delete, feed-matches, me
S10New or edit alert
/alerts/new · /alerts/[id]
iOS 7 · web W5 drawer
SheetAlertFormSizeSelectorPriceInputPriceHistogramFilterBar
PushPrompt (first alert)
—
plush, histogram, alerts-create, alerts-edit, push-token
S11Shop finder
/shops
glass C1–C2 · web W6
SearchFieldFilterBarStoreMapPricePinMapControlsStoreListStockBadgeStockNoteSheet
StoreList in a Sheet over the map
StoreList beside the mapTopBar
stores-near, search-suggest
S12Shop page
/shops/[id]
glass C3 · web W6 expanded row
ScreenHeaderStoreCardHoursTableStoreActionsStockBadgePlushRowStoreMapStockNote
—
TopBar
store, store-stock
S13Check a plush
/check
not designed yet
ScreenHeaderCodeLookupChecklistStepPhotoPickerConfidenceResultEvidencePdfButtonSheetAddToShelfFormPaywall
TagScanner (camera)
TagScanner (upload or type)
identify, auth-guide, checks-create, checks-answer, checks-result, evidence-pdf, uploads-sign
S14Me and settings
/me · /me/settings
not designed yet
ScreenHeaderSettingsListMarketSwitcherQuotaMeterMilestoneMedalThemeProvider
—
TopBar
me, me-update, push-token, export
S15Pro
/pro
iOS 8 · web W7
ScreenHeaderPlanStatusPlanCompareSheetToast
Paywall (in-app purchase)
Paywall (Stripe)
me, plans, checkout, billing-portal
S16Sign in and onboarding
/(auth)/sign-in · /onboarding
not designed yet
MarketSwitcherEmptyState
SignInButtons (Apple, Google, email)PushPrompt
SignInButtons (OAuth, magic link)
me, me-update, push-token
S17Public wanted list
/u/[handle]
not designed yet (web first)
PlushCardShelfGridWhereToBuyShareCard
—
Shown to people without the app; opens the app if installed
public-wants