Cursor rule

1---
2alwaysApply: false
3---
4 
5## Use expo-image for Optimized Images
6 
7Use `expo-image` instead of React Native's `Image`. It provides memory-efficient caching, blurhash placeholders, progressive loading, and better performance for lists.
8 
9**Incorrect (React Native Image):**
10 
11```tsx
12import { Image } from 'react-native'
13 
14function Avatar({ url }: { url: string }) {
15  return <Image source={{ uri: url }} style={styles.avatar} />
16}
17```
18 
19**Correct (expo-image):**
20 
21```tsx
22import { Image } from 'expo-image'
23 
24function Avatar({ url }: { url: string }) {
25  return <Image source={{ uri: url }} style={styles.avatar} />
26}
27```
28 
29**With blurhash placeholder:**
30 
31```tsx
32<Image
33  source={{ uri: url }}
34  placeholder={{ blurhash: 'LGF5]+Yk^6#M@-5c,1J5@[or[Q6.' }}
35  contentFit="cover"
36  transition={200}
37  style={styles.image}
38/>
39```
40 
41**With priority and caching:**
42 
43```tsx
44<Image
45  source={{ uri: url }}
46  priority="high"
47  cachePolicy="memory-disk"
48  style={styles.hero}
49/>
50```
51 
52**Key props:**
53 
54- `placeholder` — Blurhash or thumbnail while loading
55- `contentFit` — `cover`, `contain`, `fill`, `scale-down`
56- `transition` — Fade-in duration (ms)
57- `priority` — `low`, `normal`, `high`
58- `cachePolicy` — `memory`, `disk`, `memory-disk`, `none`
59- `recyclingKey` — Unique key for list recycling
60 
61For cross-platform (web + native), use `SolitoImage` from `solito/image` which uses `expo-image` under the hood.
62 
63Reference: [expo-image](https://docs.expo.dev/versions/latest/sdk/image/)
64