ui-image-gallery — правило для Claude Code
Правило ui-image-gallery задаёт стандарты для мобильных галерей: заставляет ИИ использовать библиотеку @nandorojo/galeria вместо самодельных модальных окон на Modal.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает ui-image-gallery
Правило направляет ассистента при создании мобильных галерей с полноэкранным просмотром. Вместо базового компонента Modal из React Native модель генерирует код с обёрткой Galeria из пакета @nandorojo/galeria. Это сразу обеспечивает нативные переходы shared element и масштабирование жестом.
Шаблоны кода в правиле показывают интеграцию с expo-image, SolitoImage, базовым Image и виртуализированными списками вроде FlashList. Также показана схема разделения: сетка рендерит легковесные миниатюры, а полный экран открывает адреса из массива highResUrls.
Для работы сгенерированного кода в проекте должен быть установлен пакет @nandorojo/galeria.
Какие задачи решает
- заменить самодельные модалки на готовую галерею с жестами
- настроить масштабирование картинок двумя пальцами
- связать сетку FlashList с полноэкранным просмотром
- показывать лёгкие превью до открытия тяжелых оригиналов
Примеры запросов агенту
- Сделай компонент аватара с возможностью открыть фото на весь экран через Galeria
- Напиши сетку на FlashList из трёх колонок с просмотром фото
- Собери галерею на expo-image с миниатюрами и полноразмерными снимками
Как установить ui-image-gallery
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Вручную: положить файлы
.claude/rules/ui-image-gallery.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/ui-image-gallery.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/ui-image-gallery.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/ui-image-gallery.mdВручную: положить файлы
.clinerules/ui-image-gallery.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об ui-image-gallery
Как установить ui-image-gallery в Claude Code?
Выполните в консоли /plugin marketplace add fcakyon/claude-codex-settings, а затем /plugin install react-skills@claude-settings. Либо сохраните файл правила по пути .claude/rules/ui-image-gallery.md.
Что делает правило ui-image-gallery?
Оно запрещает ассистенту писать самодельные просмотрщики картинок через стандартный Modal, требуя применять библиотеку @nandorojo/galeria.
С какими компонентами картинок работает эта библиотека?
Она поддерживает expo-image, SolitoImage, стандартный Image из React Native и любые пользовательские компоненты изображений.
Исходный текст
ui-image-gallery.md · MIT
---
title: Use Galeria for Image Galleries and Lightbox
impact: MEDIUM
impactDescription:
native shared element transitions, pinch-to-zoom, pan-to-close
tags: images, gallery, lightbox, expo-image, ui
---
## Use Galeria for Image Galleries and Lightbox
For image galleries with lightbox (tap to fullscreen), use `@nandorojo/galeria`.
It provides native shared element transitions with pinch-to-zoom, double-tap
zoom, and pan-to-close. Works with any image component including `expo-image`.
**Incorrect (custom modal implementation):**
```tsx
function ImageGallery({ urls }: { urls: string[] }) {
const [selected, setSelected] = useState<string | null>(null)
return (
<>
{urls.map((url) => (
<Pressable key={url} onPress={() => setSelected(url)}>
<Image source={{ uri: url }} style={styles.thumbnail} />
</Pressable>
))}
<Modal visible={!!selected} onRequestClose={() => setSelected(null)}>
<Image source={{ uri: selected! }} style={styles.fullscreen} />
</Modal>
</>
)
}
```
**Correct (Galeria with expo-image):**
```tsx
import { Galeria } from '@nandorojo/galeria'
import { Image } from 'expo-image'
function ImageGallery({ urls }: { urls: string[] }) {
return (
<Galeria urls={urls}>
{urls.map((url, index) => (
<Galeria.Image index={index} key={url}>
<Image source={{ uri: url }} style={styles.thumbnail} />
</Galeria.Image>
))}
</Galeria>
)
}
```
**Single image:**
```tsx
import { Galeria } from '@nandorojo/galeria'
import { Image } from 'expo-image'
function Avatar({ url }: { url: string }) {
return (
<Galeria urls={[url]}>
<Galeria.Image>
<Image source={{ uri: url }} style={styles.avatar} />
</Galeria.Image>
</Galeria>
)
}
```
**With low-res thumbnails and high-res fullscreen:**
```tsx
<Galeria urls={highResUrls}>
{lowResUrls.map((url, index) => (
<Galeria.Image index={index} key={url}>
<Image source={{ uri: url }} style={styles.thumbnail} />
</Galeria.Image>
))}
</Galeria>
```
**With FlashList:**
```tsx
<Galeria urls={urls}>
<FlashList
data={urls}
renderItem={({ item, index }) => (
<Galeria.Image index={index}>
<Image source={{ uri: item }} style={styles.thumbnail} />
</Galeria.Image>
)}
numColumns={3}
estimatedItemSize={100}
/>
</Galeria>
```
Works with `expo-image`, `SolitoImage`, `react-native` Image, or any image
component.
Reference: [Galeria](https://github.com/nandorojo/galeria)
© fcakyon · MIT · fcakyon/claude-codex-settings