138 Ecommerce
Mixed finishes

Return Items

Ecommerce Pro

Start a return by dropping items into a box that tallies the pieces and your refund. Pick a reason and a drop-off, pickup or locker, and submitting prints a prepaid QR label.

More in Ecommerce

View all 31

Agent prompt

Paste into Claude Code, Cursor or Devin to rebuild this screen.
Recreate the "Return Items" screen in React Native using LumioUI.

Goal: Start a return by dropping items into a box that tallies the pieces and your refund. Pick a reason and a drop-off, pickup or locker, and submitting prints a prepaid QR label. Match the reference implementation's layout, behavior, and motion exactly — this is a production screen, not a mockup.

## Setup

Fastest path — install the screen plus its component deps:

```bash
npx @lumioui/cli add pro/ecommerce-returns
```

Or pull just the components: `npx @lumioui/cli add action-swap animated-number button pro/countdown glass icon pro/lightbox pro/qr-code radio-group segmented-control separator text`

Native packages:
- react-native-reanimated@*
- react-native-safe-area-context@*
- react-native-svg@*

Stack assumptions: Expo SDK 54 / RN 0.81, Reanimated 4, NativeWind v4, TypeScript strict, Expo Go compatible.

## Components — how, where, when

### `action-swap` — Building blocks for swapping a label or icon in place: the old one fades as the new one appears, plainly, with a small lift or letter by letter. Includes button, text, icon and multi-state versions.
- `<ActionSwapText>` ×2

### `animated-number` — Number that moves to each new value as a calm count-up or a roll where only the changed digits turn, set in type or in dot-matrix LEDs whose dots switch on in place. Screen readers announce just the final value, not every step.
- `<AnimatedNumber>` ×1

### `button` — Pill button that presses down under your finger, in eight styles from solid to glass, with a built-in loading state that swaps in place while an action runs.
- `<Button>` ×1

### `countdown` — Live countdown with rolling digits, inline or as blocks that brighten through the final ten seconds. At zero it can celebrate and show your result, or quietly fade if time ran out.
- `<Countdown>` ×2

### `glass` — Glass surface for cards and controls: system glass on newer iOS, real refraction on the web and a frosted look elsewhere. Light can gather under your finger, and panes merge on newer iOS and the web.
- imported but not rendered directly — likely used through a sibling or as a utility

### `icon` — Icon set drawn on one consistent grid, sized and coloured from your theme. The heart, star and bookmark can fill in place inside their outline, then fade back out.
- `<Icon>` ×3

### `lightbox` — Photo gallery where any tapped photo grows out of its exact tile into a full-screen viewer, then flies back into the tile of whichever photo is showing when you let it go.
- `<LightboxProvider>` ×1
- `<LightboxImage>` ×1 — Photo opens the lightbox (paging every returnable item); the rest of the row toggles the selection.

### `qr-code` — Crisp QR code that stays sharp at any size and needs no extra library. It appears from the centre outward, can hold a logo in the middle, and fades the new code in when the value changes.
- `<QRCode>` ×1

### `radio-group` — Radio options for picking one choice from a list, as simple rows or cards. The chosen dot lights up with a soft glow while the previous choice fades.
- imported but not rendered directly — likely used through a sibling or as a utility

### `segmented-control` — Segmented control for switching between a few options, with text segments that can carry icons. The highlight slides smoothly to your pick and can be dragged, and a glass style suits photos.
- imported but not rendered directly — likely used through a sibling or as a utility

### `separator` — Thin divider line, horizontal or vertical. It can draw itself in as a page builds, or show a perforated tear line for tickets and receipts.
- `<Separator>` ×1

### `text` — Themed type scale from caption to display that follows light and dark mode. Includes a pull-quote style with an accent rule and a quieter dimmed tone for secondary text.
- `<Text>` ×19

## Conventions (non-negotiable)

- Styling via NativeWind `className` with semantic tokens only: `bg-background`, `text-foreground`, `bg-card`, `text-card-foreground`, `bg-secondary`, `bg-muted`, `text-muted-foreground`, `bg-accent`, `bg-destructive`, `border-border`. Hard-coded colors only inside media overlays (`text-white`, `bg-black/N`).
- Motion via the token presets from `@lumioui/core` (`spring.press`, `spring.surface`, `spring.glide`, `timing.fast`, `timing.slow`, …) — no bespoke spring configs or durations.
- Gate transform motion behind `useReducedMotion()`; keep opacity/color feedback, drop travel and overshoot.
- Haptics via `useHaptic()`: `light` on press, `selection` on toggle/select, `warning` on invalid input. Never import expo-haptics directly.
- Press feedback via `usePressAnimation()` (~0.97 scale), not `activeOpacity` tricks.
- a11y: `accessibilityRole` + `accessibilityLabel` on every control, touch targets ≥44pt.
- Entrance choreography: staggered `Mount` wrappers (delay 0/60/120…) so regions land in sequence instead of popping in at once.
- Wrap the screen in `SafeAreaView`; keep dark mode working via the semantic tokens.

## Deliverable

One file: `screens/ecommerce/returns.tsx` exporting ReturnsScreen. Preserve the props interface — the host app wires the callbacks (navigation, submit handlers) through them.

## Reference implementation

This is a LumioUI Pro item: its source is not published in the docs. Install it with a Pro license key
(set `LUMIO_LICENSE_KEY`; keys are on lumioui.com/account) and read the installed file as the reference:

```bash
npx @lumioui/cli add pro/ecommerce-returns
```

The source lands at `screens/ecommerce/returns.tsx`.

Screen: https://lumioui.com/screens/ecommerce-returns