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:
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.
Also for each screen check components. I mean, for each screen, which components are used.
Plush Scout · build spec · draft 3 Oct 2026
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.
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).Name.tsx; react-native-web renders them in the browser.null or a fallback), so every import resolves on all three.app/ (Expo Router) and pick up the right platform components automatically. Colours and type come from the shared 15-theme tokens.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
Each row says what the component does, how the iOS/Android and web versions differ, and which screens use it.
| Component | Files | What it does | iOS / Android | Web | Used on |
|---|---|---|---|---|---|
| App shell | |||||
| AppTabs Split | AppTabs.tsxAppTabs.web.tsx | Main 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.tsx | Starts 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.tsx | Page 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 · stub | Global 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.tsx | Round 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.tsx | Search 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 · stub | Keyboard quick search and actions (⌘K). | Stub. | Modal list of plush, shops and actions. | S1, S6 |
| Sheet Split | Sheet.tsxSheet.web.tsx | Container 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.tsx | Supplies the 15 themes in light and dark as tokens and follows system appearance. | — | — | Every screen (app root) |
| Toast Shared | Toast.tsx | Short confirmations such as "Alert created". | — | — | S15 |
| EmptyState Shared | EmptyState.tsx | Friendly empty and error screens with the Peekaboo mascot. | — | — | S1, S2, S6, S9, S16 |
| Skeleton Shared | Skeleton.tsx | Loading placeholders shaped like the content. | — | — | S1, S6 |
| Plush | |||||
| PlushImage Shared | PlushImage.tsx | Plush 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.tsx | Grid tile: photo, status, size tag, value and price paid. | — | — | S1, S2, S6, S17 |
| PlushRow Shared | PlushRow.tsx | Compact row: thumbnail, name, size, price or change. | — | — | S1, S3, S12 |
| StatusPill Shared | StatusPill.tsx | In production, out of stock, retiring, retired or likely retired. | — | — | S1, S2, S3, S4, S6, S7 |
| SizeSelector Shared | SizeSelector.tsx | Sizes with height and status; sold-out sizes crossed out. | — | — | S7, S10 |
| TagDetails Shared | TagDetails.tsx | Tag code, height, UK and US RRP, released and retired dates. | — | — | S7 |
| RetiredSeal Shared | RetiredSeal.tsx | Round "Retired Jan 26" badge on the plush image. | — | — | S7 |
| DemandBar Shared | DemandBar.tsx | How 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.tsx | Low, typical and high asking prices with today's lowest marked. | react-native-svg. | Same SVG. | S7 |
| PriceChart Split | PriceChart.tsxPriceChart.web.tsx | Median 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.tsx | Spread 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.tsx | Small 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.tsx | Label, large value and change, e.g. "Estimated value £2,140". | — | — | S2, S5, S8 |
| RangeChips Shared | RangeChips.tsx | 1M, 3M, 1Y and All switch for charts. | — | — | S7 |
| Listings | |||||
| ListingList Split | ListingList.tsxListingList.web.tsx | Every listing for one size of a plush. | Virtualised rows (FlashList). | Sortable table with columns and sticky header. | S8 |
| WhereToBuy Shared | WhereToBuy.tsx | Best few offers (best new price, cheapest resale) with "See all". | — | — | S4, S7, S17 |
| SourceBadge Shared | SourceBadge.tsx | Shop or marketplace mark (initials or logo). | — | — | S7, S8 |
| StockBadge Shared | StockBadge.tsx | In stock, 2 left, low stock, sold out or shop only. | — | — | S7, S8, S11, S12 |
| FilterBar Split | FilterBar.tsxFilterBar.web.tsx | Filters 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.tsx | Recent sold prices with date, source and condition. | — | — | S7 |
| AffiliateDisclosure Shared | AffiliateDisclosure.tsx | eBay Partner Network notice wherever buying links appear. | — | — | S7, S8 |
| OutboundLink Split | OutboundLink.tsxOutboundLink.web.tsx | Opens 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.tsx | Owned and Wanted switch, totals, share and export actions. | — | — | S2, S3 |
| CollectionList Split | CollectionList.tsxCollectionList.web.tsx | Your named shelves (Bashful bunnies, Retired gems…). | Big picture cards. | Collections and filters down the left of the shelf. | S2 |
| ShelfGrid Shared | ShelfGrid.tsx | Responsive grid of PlushCards: 2 across on phones, 5 on desktop. | — | — | S2, S6, S17 |
| ValueCard Shared | ValueCard.tsx | Estimated collection value, 30-day change and sparkline. | — | — | S1, S2 |
| SetCompletion Shared | SetCompletion.tsx | Progress ring and owned versus missing slots for a design line. | — | — | S4 |
| MilestoneMedal Shared | MilestoneMedal.tsx | Holographic medal with progress toward the next one. | — | — | S5, S14 |
| AddToShelfForm Shared | AddToShelfForm.tsx | Condition, tags on or off, price paid, date, shop and photos. | — | — | S2, S7, S13 |
| PhotoPicker Shared | PhotoPicker.tsx | Take 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.tsx | Shareable 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.tsx | Your alerts with on and off switches and last match. | Rows with switches. | Table with columns. | S9 |
| AlertForm Shared | AlertForm.tsx | Alert 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.tsx | Currency field showing the current lowest price beside it. | Numeric keypad. | — | S7, S10 |
| MatchFeed Shared | MatchFeed.tsx | Alerts that fired: what, where, price and when. | — | — | S1, S9 |
| QuotaMeter Shared | QuotaMeter.tsx | Free plan usage (3 of 3 alerts, 1 of 3 checks) with a Try Pro link; hidden on Pro. | — | — | S3, S9, S14 |
| RestockRadarCard Shared | RestockRadarCard.tsx | Tonight's drop window and how many of your wants are being watched. | — | — | S1 |
| PushPrompt iOS/Android only | PushPrompt.tsxPushPrompt.web.tsx · stub | Asks for notification permission with the mascot. | expo-notifications. | Stub (web push can come later). | S10, S16 |
| Shops | |||||
| StoreMap Split | StoreMap.tsxStoreMap.web.tsx | Map 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.tsx | Map marker showing price, initials or a grey "no stock" state. | Custom marker view. | HTML marker. | S11 |
| MapControls Split | MapControls.tsxMapControls.web.tsx | Locate me, zoom and layers. | Glass button stack on iOS. | Zoom buttons and locate. | S11 |
| StoreList Shared | StoreList.tsx | Shops sorted by distance with stock, price and opening hours. | Inside a Sheet over the map. | Column beside the map. | S11 |
| StoreCard Shared | StoreCard.tsx | One shop: hours, distance, stock for your wants and actions. | — | — | S12 |
| StoreActions Shared | StoreActions.tsx | Directions, 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.tsx | Opening 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.tsx | Reads 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.tsx | Type a tag code, SKU or barcode with suggestions. | — | — | S13 |
| ChecklistStep Shared | ChecklistStep.tsx | One authenticity check with real and fake photo examples; yes, no or not sure. | — | — | S13 |
| ConfidenceResult Shared | ConfidenceResult.tsx | Confidence meter and verdict, worded as a guide, not a guarantee. | — | — | S13 |
| EvidencePdfButton Shared | EvidencePdfButton.tsx | Makes the dispute evidence PDF on the server, then opens or shares it. | Share sheet. | Download link. | S13 |
| Account | |||||
| SignInButtons Split | SignInButtons.tsxSignInButtons.web.tsx | Sign 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.tsx | Pro 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.tsx | Locks a Pro section on Free: blurs it and shows a "Try Pro" chip that opens the paywall. | — | — | S1, S2, S7 |
| PlanStatus Shared | PlanStatus.tsx | Shows 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.tsx | Free 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.tsx | UK or US prices and currency. | — | — | S14, S16 |
| SettingsList Shared | SettingsList.tsx | Notifications, theme, market, export and account settings. | — | — | S14 |
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.
| # | Screen | Components on every platform | iOS / Android | Web | APIs |
|---|---|---|---|---|---|
| S1 | Home / (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 |
| S2 | My 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 |
| S3 | Wanted (watchlist) /shelf?view=wanted glass B1 | ShelfHeaderPlushRowSparklineChangePillStatusPillQuotaMeterSheetAlertFormShareCard | — | TopBar | wants-list, wants-add, wants-remove, alerts-create, iso-card |
| S4 | Complete the set /shelf/sets/[line] glass A2 | ScreenHeaderSetCompletionFilterBarPlushImageStatusPillSheetWhereToBuy | — | TopBar | sets-detail, where-to-buy |
| S5 | Milestones /me/milestones glass A3 | ScreenHeaderMilestoneMedalStatTile | — | TopBar | milestones |
| S6 | Catalogue and search /catalogue · /search?q= not designed yet | SearchFieldFilterBarShelfGridPlushCardStatusPillEmptyStateSkeleton | — | TopBarCommandPalette | catalogue-search, search-suggest, feed-retired |
| S7 | Plush 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 |
| S8 | Every listing /plush/[slug]/[size]/listings iOS 5 · web W4 | ScreenHeaderFilterBarPriceHistogramStatTileListingListSourceBadgeStockBadgeOutboundLinkAffiliateDisclosure | ListingList (rows) | ListingList (table)TopBar | listings, histogram, out, alerts-create |
| S9 | Alerts /alerts iOS 6 · glass B3 · web W5 | ScreenHeaderAlertListQuotaMeterPlanStatusMatchFeedEmptyStateSheetAlertForm | AlertList (rows) | AlertList (table)TopBar | alerts-list, alerts-edit, alerts-delete, feed-matches, me |
| S10 | New or edit alert /alerts/new · /alerts/[id] iOS 7 · web W5 drawer | SheetAlertFormSizeSelectorPriceInputPriceHistogramFilterBar | PushPrompt (first alert) | — | plush, histogram, alerts-create, alerts-edit, push-token |
| S11 | Shop finder /shops glass C1–C2 · web W6 | SearchFieldFilterBarStoreMapPricePinMapControlsStoreListStockBadgeStockNoteSheet | StoreList in a Sheet over the map | StoreList beside the mapTopBar | stores-near, search-suggest |
| S12 | Shop page /shops/[id] glass C3 · web W6 expanded row | ScreenHeaderStoreCardHoursTableStoreActionsStockBadgePlushRowStoreMapStockNote | — | TopBar | store, store-stock |
| S13 | Check 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 |
| S14 | Me and settings /me · /me/settings not designed yet | ScreenHeaderSettingsListMarketSwitcherQuotaMeterMilestoneMedalThemeProvider | — | TopBar | me, me-update, push-token, export |
| S15 | Pro /pro iOS 8 · web W7 | ScreenHeaderPlanStatusPlanCompareSheetToast | Paywall (in-app purchase) | Paywall (Stripe) | me, plans, checkout, billing-portal |
| S16 | Sign 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 |
| S17 | Public wanted list /u/[handle] not designed yet (web first) | PlushCardShelfGridWhereToBuyShareCard | — | Shown to people without the app; opens the app if installed | public-wants |