v0.1 public beta early access on GitHub
Home / Screens / ecommerce-store-home
Screen template

Store home Screen

Shopfront with photo hero, store card, category rail, and product grid.

pro Expo Go ✓ iosandroid gestures: tap · scroll haptics: light · selection
$ npx lumioui add ecommerce-store-home
import { StoreHomeScreen } from "@/screens/ecommerce/store-home";
Native packages installed6
@lumioui/ui@latest@lumioui/core@latestreact-native-safe-area-context@*react-native-reanimated@*react-native-svg@*nativewind@*
ecommerce/store-home.tsxsource · yours to edit
import * as React from "react";
import { ScrollView, View } from "react-native";
import { SafeAreaView, useSafeAreaInsets } from "react-native-safe-area-context";
import { Button, Chip, Icon, Image, Separator, Text, Glass, } from "@lumioui/ui";
import { useHaptic } from "@lumioui/core";
import { BLOCK_STAGGER, catalogImg, type CatalogPhoto, LumioMark, Mount, Press, SERIF } from "../shared";

export interface StoreProduct {
  id: string;
  title: string;
  price: string;
  photo: CatalogPhoto;
}

export interface StoreHomeScreenProps {
  storeName?: string;
  storeHandle?: string;
  /** e.g. "4.9 · 2.1k reviews" */
  rating?: string;
  followers?: string;
  heroPhoto?: CatalogPhoto;
  categories?: string[];
  products?: StoreProduct[];
  onProductPress?: (id: string) => void;
  onFollow?: () => void;
  onBack?: () => void;
}

const DEFAULT_PRODUCTS: StoreProduct[] = [
  { id: "p1", title: "Oversized wool overcoat", price: "$289", photo: "overcoat" },
  { id: "p2", title: "Cream knit poncho", price: "$96", photo: "poncho" },
  { id: "p3", title: "Raw denim jeans", price: "$148", photo: "denim" },
  { id: "p4", title: "Tan bomber jacket", price: "$185", photo: "bomber" },
];

const DEFAULT_CATEGORIES = ["All", "Outerwear", "Knitwear", "Denim", "New"];

/** Store home — shopfront: photo hero, store card, category chips, grid. */
export function StoreHomeScreen({
  storeName = "Atelier Nord",
  storeHandle = "@ateliernord",
  rating = "4.9 · 2.1k reviews",
  followers = "18.4k followers",
  heroPhoto = "shop",
  categories = DEFAULT_CATEGORIES,
  products = DEFAULT_PRODUCTS,
  onProductPress,
  onFollow,
  onBack,
}: StoreHomeScreenProps) {
  const haptics = useHaptic();
  const insets = useSafeAreaInsets();
  const [category, setCategory] = React.useState(categories[0] ?? "All");
  const [following, setFollowing] = React.useState(false);

  return (
    <SafeAreaView className="flex-1 bg-[#F4F5F9] dark:bg-[#111114]" edges={["top"]}>
      <ScrollView
        showsVerticalScrollIndicator={false}
        contentContainerStyle={{ paddingBottom: insets.bottom + 32 }}
      >
        {/* Shop photo hero — taller, title overlaid on a scrim so the
            storefront itself carries the masthead. */}
        <Mount className="relative">
          <Image
            source={{ uri: catalogImg(heroPhoto, 800, 480) }}
            className="h-60 w-full bg-muted"
            accessibilityLabel={`${storeName} storefront`}
          />
          <View className="absolute inset-x-0 bottom-0 h-24 bg-black/40" />
          <View className="absolute inset-x-0 bottom-0 px-6 pb-4">
            <Text className="text-3xl font-extralight tracking-tight text-white" style={{ fontFamily: SERIF }}>
              {storeName}
            </Text>
          </View>
          {/* Announcement chip — the store's one promotion rides the hero. */}
          <View className="absolute bottom-4 right-4 rounded-full bg-[#BEF04C] px-3 py-1">
            <Text className="text-[11px] font-semibold text-[#1B1B26]">
              Free shipping over $75
            </Text>
          </View>
          <Glass interactive effect="clear" className="absolute left-4 top-3 rounded-full">
          <Button
            variant="ghost"
            size="icon"
            haptic="light"
            onPress={() => onBack?.()}
            accessibilityLabel="Go back"
            className="h-10 w-10 rounded-full"
          >
            <Icon name="chevron-left" size="md" color="foreground" />
          </Button>
          </Glass>
          {/* Platform brand pill — the marketplace fronts every storefront.
              Glass is the background layer only: its web material blurs SVG
              children, so mark + text sit as siblings on top. */}
          <View pointerEvents="none" className="absolute inset-x-0 top-3 items-center">
            <View className="h-11 flex-row items-center gap-2 rounded-full pl-3 pr-5">
              <Glass
                effect="regular"
                className="absolute inset-0 rounded-full"
              />
              <LumioMark size={20} />
              <Text className="text-sm font-bold tracking-tight text-white">
                Lumio Market
              </Text>
            </View>
          </View>
        </Mount>

        {/* Store meta — stats as one tight line, follow sits right. */}
        <Mount delay={BLOCK_STAGGER} className="flex-row items-center gap-3 px-6 pb-4 pt-3">
          <View className="flex-1">
            <Text variant="small" className="text-muted-foreground">
              {storeHandle} · {rating}
            </Text>
            <Text variant="small" className="text-muted-foreground">
              {followers}
            </Text>
          </View>
          <Button
            variant={following ? "secondary" : "default"}
            tone={following ? undefined : "inverse"}
            size="sm"
            haptic="medium"
            onPress={() => {
              haptics.medium();
              setFollowing((f) => !f);
              onFollow?.();
            }}
            accessibilityLabel={following ? `Unfollow ${storeName}` : `Follow ${storeName}`}
          >
            {following ? "Following" : "Follow"}
          </Button>
        </Mount>

        {/* Category rail */}
        <Mount delay={BLOCK_STAGGER * 2}>
        <ScrollView
          horizontal
        className="grow-0"
          showsHorizontalScrollIndicator={false}
          contentContainerStyle={{ gap: 8, paddingHorizontal: 24, paddingBottom: 16 }}
        >
          {categories.map((c) => (
            <Chip
              key={c}
              size="sm"
              variant="filter"
              selected={category === c}
              selectedClassName="border-[#BEF04C] bg-[#BEF04C]"
              selectedTextClassName="font-semibold text-[#1B1B26]"
              onPress={() => {
                haptics.selection();
                setCategory(c);
              }}
              accessibilityState={{ selected: category === c }}
            >
              {c}
            </Chip>
          ))}
        </ScrollView>
        </Mount>

        {/* Featured rail — large tiles that scroll sideways, not a grid. */}
        <Mount delay={BLOCK_STAGGER * 3}>
          <View className="flex-row items-baseline justify-between px-6 pb-3">
            <Text variant="h3">Featured</Text>
            <Text variant="small" className="text-muted-foreground">
              {products.length} pieces
            </Text>
          </View>
          <ScrollView
            horizontal
            className="grow-0"
            showsHorizontalScrollIndicator={false}
            contentContainerStyle={{ gap: 12, paddingHorizontal: 24 }}
          >
            {products.map((item) => (
              <Press
                key={item.id}
                haptic="light"
                onPress={() => onProductPress?.(item.id)}
                accessibilityLabel={`${item.title}, ${item.price}`}
                className="w-44 items-start justify-start p-0"
              >
                <View className="w-44">
                  <Image
                    source={{ uri: catalogImg(item.photo, 400, 500) }}
                    className="aspect-[4/5] w-44 rounded-2xl bg-muted"
                    accessibilityLabel={item.title}
                  />
                  <View className="items-start gap-0.5 px-0.5 pt-2">
                    <Text variant="small" numberOfLines={1}>
                      {item.title}
                    </Text>
                    <Text variant="small" className="font-semibold">
                      {item.price}
                    </Text>
                  </View>
                </View>
              </Press>
            ))}
          </ScrollView>
        </Mount>

        {/* New arrivals — quiet text rows under the loud rail. */}
        <Mount delay={BLOCK_STAGGER * 4} className="px-6 pt-6">
          <Text variant="h3" className="pb-2">New arrivals</Text>
          <View className="rounded-2xl border border-border bg-card">
            {products.map((item, i) => (
              <View key={item.id}>
                {i > 0 ? <Separator /> : null}
                <Press
                  haptic="light"
                  onPress={() => onProductPress?.(item.id)}
                  accessibilityLabel={`${item.title}, ${item.price}`}
                  className="flex-row items-center gap-3 px-4 py-3"
                >
                  <Image
                    source={{ uri: catalogImg(item.photo, 160, 160) }}
                    className="h-14 w-14 rounded-xl bg-muted"
                    accessibilityLabel={item.title}
                  />
                  <View className="flex-1">
                    <Text variant="small" numberOfLines={1}>
                      {item.title}
                    </Text>
                    <Text variant="small" className="text-muted-foreground">
                      {item.price}
                    </Text>
                  </View>
                  <Icon name="chevron-right" size="sm" color="mutedForeground" />
                </Press>
              </View>
            ))}
          </View>
        </Mount>
      </ScrollView>
    </SafeAreaView>
  );
}
StoreHomeScreen.displayName = "StoreHomeScreen";
agent prompt — paste into Claude Code, Cursor, Devin…
Recreate the "Store home Screen" screen in React Native using LumioUI.

Goal: Shopfront with photo hero, store card, category rail, and product grid. 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 add ecommerce-store-home
```

Or pull just the components: `npx lumioui add avatar button chip glass icon image separator text`

Native packages:
- @lumioui/ui@latest
- @lumioui/core@latest
- react-native-safe-area-context@*
- react-native-reanimated@*
- react-native-svg@*
- nativewind@*

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

## Components — how, where, when

### `avatar` — Circular user image with fallback initials and status dot.
- imported but not rendered directly — likely used through a sibling or as a utility

### `button` — Tactile pill button with press spring, ink wash and async loading.
- `<Button>` ×2

### `chip` — Compact selectable pill with press scale and ink overlay.
- `<Chip>` ×1

### `glass` — iOS 26 liquid-glass surface — real glass via expo-glass-effect (Expo Go) or @callstack/liquid-glass (dev builds), SVG refraction + specular rim on web, frosted fallback elsewhere; GlassContainer melts adjacent panes into one blob
- `<Glass>` ×2

### `icon` — Lucide icon set mapped to theme colors and sizes.
- `<Icon>` ×2

### `image` — Cached image with placeholder, fallback and aspect handling.
- `<Image>` ×3

### `separator` — Hairline rule with orientation and spacing control.
- `<Separator>` ×1

### `text` — Themed type scale from caption to display.
- `<Text>` ×12

## 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/store-home.tsx` exporting StoreHomeScreen. Preserve the props interface — the host app wires the callbacks (navigation, submit handlers) through them.

## Reference implementation

The LumioUI source for this screen — reproduce it faithfully:

```tsx
import * as React from "react";
import { ScrollView, View } from "react-native";
import { SafeAreaView, useSafeAreaInsets } from "react-native-safe-area-context";
import { Button, Chip, Icon, Image, Separator, Text, Glass, } from "@lumioui/ui";
import { useHaptic } from "@lumioui/core";
import { BLOCK_STAGGER, catalogImg, type CatalogPhoto, LumioMark, Mount, Press, SERIF } from "../shared";

export interface StoreProduct {
  id: string;
  title: string;
  price: string;
  photo: CatalogPhoto;
}

export interface StoreHomeScreenProps {
  storeName?: string;
  storeHandle?: string;
  /** e.g. "4.9 · 2.1k reviews" */
  rating?: string;
  followers?: string;
  heroPhoto?: CatalogPhoto;
  categories?: string[];
  products?: StoreProduct[];
  onProductPress?: (id: string) => void;
  onFollow?: () => void;
  onBack?: () => void;
}

const DEFAULT_PRODUCTS: StoreProduct[] = [
  { id: "p1", title: "Oversized wool overcoat", price: "$289", photo: "overcoat" },
  { id: "p2", title: "Cream knit poncho", price: "$96", photo: "poncho" },
  { id: "p3", title: "Raw denim jeans", price: "$148", photo: "denim" },
  { id: "p4", title: "Tan bomber jacket", price: "$185", photo: "bomber" },
];

const DEFAULT_CATEGORIES = ["All", "Outerwear", "Knitwear", "Denim", "New"];

/** Store home — shopfront: photo hero, store card, category chips, grid. */
export function StoreHomeScreen({
  storeName = "Atelier Nord",
  storeHandle = "@ateliernord",
  rating = "4.9 · 2.1k reviews",
  followers = "18.4k followers",
  heroPhoto = "shop",
  categories = DEFAULT_CATEGORIES,
  products = DEFAULT_PRODUCTS,
  onProductPress,
  onFollow,
  onBack,
}: StoreHomeScreenProps) {
  const haptics = useHaptic();
  const insets = useSafeAreaInsets();
  const [category, setCategory] = React.useState(categories[0] ?? "All");
  const [following, setFollowing] = React.useState(false);

  return (
    <SafeAreaView className="flex-1 bg-[#F4F5F9] dark:bg-[#111114]" edges={["top"]}>
      <ScrollView
        showsVerticalScrollIndicator={false}
        contentContainerStyle={{ paddingBottom: insets.bottom + 32 }}
      >
        {/* Shop photo hero — taller, title overlaid on a scrim so the
            storefront itself carries the masthead. */}
        <Mount className="relative">
          <Image
            source={{ uri: catalogImg(heroPhoto, 800, 480) }}
            className="h-60 w-full bg-muted"
            accessibilityLabel={`${storeName} storefront`}
          />
          <View className="absolute inset-x-0 bottom-0 h-24 bg-black/40" />
          <View className="absolute inset-x-0 bottom-0 px-6 pb-4">
            <Text className="text-3xl font-extralight tracking-tight text-white" style={{ fontFamily: SERIF }}>
              {storeName}
            </Text>
          </View>
          {/* Announcement chip — the store's one promotion rides the hero. */}
          <View className="absolute bottom-4 right-4 rounded-full bg-[#BEF04C] px-3 py-1">
            <Text className="text-[11px] font-semibold text-[#1B1B26]">
              Free shipping over $75
            </Text>
          </View>
          <Glass interactive effect="clear" className="absolute left-4 top-3 rounded-full">
          <Button
            variant="ghost"
            size="icon"
            haptic="light"
            onPress={() => onBack?.()}
            accessibilityLabel="Go back"
            className="h-10 w-10 rounded-full"
          >
            <Icon name="chevron-left" size="md" color="foreground" />
          </Button>
          </Glass>
          {/* Platform brand pill — the marketplace fronts every storefront.
              Glass is the background layer only: its web material blurs SVG
              children, so mark + text sit as siblings on top. */}
          <View pointerEvents="none" className="absolute inset-x-0 top-3 items-center">
            <View className="h-11 flex-row items-center gap-2 rounded-full pl-3 pr-5">
              <Glass
                effect="regular"
                className="absolute inset-0 rounded-full"
              />
              <LumioMark size={20} />
              <Text className="text-sm font-bold tracking-tight text-white">
                Lumio Market
              </Text>
            </View>
          </View>
        </Mount>

        {/* Store meta — stats as one tight line, follow sits right. */}
        <Mount delay={BLOCK_STAGGER} className="flex-row items-center gap-3 px-6 pb-4 pt-3">
          <View className="flex-1">
            <Text variant="small" className="text-muted-foreground">
              {storeHandle} · {rating}
            </Text>
            <Text variant="small" className="text-muted-foreground">
              {followers}
            </Text>
          </View>
          <Button
            variant={following ? "secondary" : "default"}
            tone={following ? undefined : "inverse"}
            size="sm"
            haptic="medium"
            onPress={() => {
              haptics.medium();
              setFollowing((f) => !f);
              onFollow?.();
            }}
            accessibilityLabel={following ? `Unfollow ${storeName}` : `Follow ${storeName}`}
          >
            {following ? "Following" : "Follow"}
          </Button>
        </Mount>

        {/* Category rail */}
        <Mount delay={BLOCK_STAGGER * 2}>
        <ScrollView
          horizontal
        className="grow-0"
          showsHorizontalScrollIndicator={false}
          contentContainerStyle={{ gap: 8, paddingHorizontal: 24, paddingBottom: 16 }}
        >
          {categories.map((c) => (
            <Chip
              key={c}
              size="sm"
              variant="filter"
              selected={category === c}
              selectedClassName="border-[#BEF04C] bg-[#BEF04C]"
              selectedTextClassName="font-semibold text-[#1B1B26]"
              onPress={() => {
                haptics.selection();
                setCategory(c);
              }}
              accessibilityState={{ selected: category === c }}
            >
              {c}
            </Chip>
          ))}
        </ScrollView>
        </Mount>

        {/* Featured rail — large tiles that scroll sideways, not a grid. */}
        <Mount delay={BLOCK_STAGGER * 3}>
          <View className="flex-row items-baseline justify-between px-6 pb-3">
            <Text variant="h3">Featured</Text>
            <Text variant="small" className="text-muted-foreground">
              {products.length} pieces
            </Text>
          </View>
          <ScrollView
            horizontal
            className="grow-0"
            showsHorizontalScrollIndicator={false}
            contentContainerStyle={{ gap: 12, paddingHorizontal: 24 }}
          >
            {products.map((item) => (
              <Press
                key={item.id}
                haptic="light"
                onPress={() => onProductPress?.(item.id)}
                accessibilityLabel={`${item.title}, ${item.price}`}
                className="w-44 items-start justify-start p-0"
              >
                <View className="w-44">
                  <Image
                    source={{ uri: catalogImg(item.photo, 400, 500) }}
                    className="aspect-[4/5] w-44 rounded-2xl bg-muted"
                    accessibilityLabel={item.title}
                  />
                  <View className="items-start gap-0.5 px-0.5 pt-2">
                    <Text variant="small" numberOfLines={1}>
                      {item.title}
                    </Text>
                    <Text variant="small" className="font-semibold">
                      {item.price}
                    </Text>
                  </View>
                </View>
              </Press>
            ))}
          </ScrollView>
        </Mount>

        {/* New arrivals — quiet text rows under the loud rail. */}
        <Mount delay={BLOCK_STAGGER * 4} className="px-6 pt-6">
          <Text variant="h3" className="pb-2">New arrivals</Text>
          <View className="rounded-2xl border border-border bg-card">
            {products.map((item, i) => (
              <View key={item.id}>
                {i > 0 ? <Separator /> : null}
                <Press
                  haptic="light"
                  onPress={() => onProductPress?.(item.id)}
                  accessibilityLabel={`${item.title}, ${item.price}`}
                  className="flex-row items-center gap-3 px-4 py-3"
                >
                  <Image
                    source={{ uri: catalogImg(item.photo, 160, 160) }}
                    className="h-14 w-14 rounded-xl bg-muted"
                    accessibilityLabel={item.title}
                  />
                  <View className="flex-1">
                    <Text variant="small" numberOfLines={1}>
                      {item.title}
                    </Text>
                    <Text variant="small" className="text-muted-foreground">
                      {item.price}
                    </Text>
                  </View>
                  <Icon name="chevron-right" size="sm" color="mutedForeground" />
                </Press>
              </View>
            ))}
          </View>
        </Mount>
      </ScrollView>
    </SafeAreaView>
  );
}
StoreHomeScreen.displayName = "StoreHomeScreen";
```

Screen: https://lumioui.dev/screens/ecommerce-store-home
iPhone 17 · iOS
9:41
Live preview — the real screen via Expo Web · open full ↗