123 Ecommerce
Mixed finishes

Filters & Sort

Ecommerce Pro

Narrow a category with sort, a price histogram, sizes, colours and toggles in one sheet, with a live count of matching pieces. Applying shows the grid reshuffle to what’s left instead of jumping away.

More in Ecommerce

View all 31

Agent prompt

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

Goal: Narrow a category with sort, a price histogram, sizes, colours and toggles in one sheet, with a live count of matching pieces. Applying shows the grid reshuffle to what’s left instead of jumping away. 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-filters-sort
```

Or pull just the components: `npx @lumioui/cli add action-swap animated-number icon image pro/range-slider switch 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>` ×1 — The count swaps in place: the old label dims while the new one ignites with a short rise.

### `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.
- 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>` ×2

### `image` — Image with a placeholder while it loads, a fallback when it fails, and aspect-ratio handling so your layout doesn’t jump when the picture arrives.
- `<Image>` ×1

### `range-slider` — Two-thumb slider for picking a range, with smooth thumbs and a tick you can feel at each step. A chart behind the track lights up inside your range, and the labels merge when they meet.
- `<RangeSlider>` ×1

### `switch` — On/off switch whose colour fills in from behind the thumb as it turns on. Turning off fades it back quickly, and a disabled switch gives a gentle flicker when tapped.
- `<Switch>` ×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>` ×13

## 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/filters-sort.tsx` exporting FiltersSortScreen. 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-filters-sort
```

The source lands at `screens/ecommerce/filters-sort.tsx`.

Screen: https://lumioui.com/screens/ecommerce-filters-sort