Gallery
The Gallery provides a comprehensive view of all your generated images with powerful search, filtering, and bulk operations.
Overview
The Gallery is your central hub for:
- Browsing all generated and edited images
- Searching by prompt, date, or metadata
- Filtering by operation type, aspect ratio, session
- Bulk operations for download, delete, or edit
- Viewing image details and edit history
View Modes
Grid View (Default)
Standard grid layout with uniform thumbnails:
┌─────┬─────┬─────┬─────┐
│ 🖼️ │ 🖼️ │ 🖼️ │ 🖼️ │
├─────┼─────┼─────┼─────┤
│ 🖼️ │ 🖼️ │ 🖼️ │ 🖼️ │
├─────┼─────┼─────┼─────┤
│ 🖼️ │ 🖼️ │ 🖼️ │ 🖼️ │
└─────┴─────┴─────┴─────┘Controls:
- Thumbnail size slider
- Columns: Auto, 2, 3, 4, 5, 6
Masonry View
Pinterest-style layout preserving aspect ratios:
┌─────┬─────┬─────┬─────┐
│ 🖼️ │ │ 🖼️ │ │
│ │ 🖼️ ├─────┤ 🖼️ │
├─────┤ │ 🖼️ │ │
│ 🖼️ ├─────┤ ├─────┤
│ │ 🖼️ │ │ 🖼️ │
└─────┴─────┴─────┴─────┘Best for mixed aspect ratio collections.
List View
Detailed list with metadata columns:
┌──────────────────────────────────────────────────────┐
│ 🖼️ Sunset over mountains 1024x768 2.3 MB │
│ Generated • Jan 15, 2024 • Session: abc123 │
├──────────────────────────────────────────────────────┤
│ 🖼️ Portrait with clouds 768x1024 1.8 MB │
│ Edited • Jan 15, 2024 • Session: abc123 │
└──────────────────────────────────────────────────────┘Best for detailed information and sorting.
Search
Basic Search
Type in the search bar to find images by prompt:
┌────────────────────────────────────┐
│ 🔍 sunset mountains │
└────────────────────────────────────┘Search Modes
| Mode | Behavior | Example |
|---|---|---|
| All Words | Match all terms | "sunset mountains" finds images with both |
| Any Word | Match any term | "sunset mountains" finds images with either |
| Exact Phrase | Match exact phrase | "sunset over mountains" finds exact match |
Advanced Search Syntax
# Search by prompt text
sunset mountains
# Search by session
session:abc123
# Search by date range
created:2024-01-15
# Combined search
sunset session:abc123Filters
Filter Panel
Click the filter icon to expand options:
┌─────────────────────────────────────┐
│ Filters [×] │
├─────────────────────────────────────┤
│ Operation Type │
│ ○ All ● Generate ○ Edit │
├─────────────────────────────────────┤
│ Aspect Ratio │
│ ☐ Square ☐ Portrait ☐ Landscape │
│ ☐ 16:9 ☐ 9:16 │
├─────────────────────────────────────┤
│ Date Range │
│ From: [Jan 1, 2024 ] │
│ To: [Jan 31, 2024] │
├─────────────────────────────────────┤
│ Session │
│ [Select session... ▼] │
├─────────────────────────────────────┤
│ Style Preset │
│ [Any preset... ▼] │
├─────────────────────────────────────┤
│ Character │
│ [Any character... ▼] │
├─────────────────────────────────────┤
│ [Apply Filters] [Clear All] │
└─────────────────────────────────────┘Quick Filters
One-click filter buttons:
| Filter | Shows |
|---|---|
| Today | Images from today |
| This Week | Last 7 days |
| Generated | Only generations |
| Edited | Only edits |
| With Character | Character-based images |
| With Product | Product marketing images |
Saved Filter Presets
Save frequently used filter combinations:
┌─────────────────────────────────────┐
│ Saved Presets [+] │
├─────────────────────────────────────┤
│ 📁 Marketing Images │
│ 📁 Character Scenes │
│ 📁 This Month's Work │
└─────────────────────────────────────┘Sorting
Sort images by various criteria:
| Sort Option | Description |
|---|---|
| Newest First | Most recent first (default) |
| Oldest First | Chronological order |
| Largest First | By file size descending |
| Smallest First | By file size ascending |
| Most Edits | Images with most edit iterations |
Selection
Single Selection
Click an image to select it:
┌─────────────────┐
│ ✓ 🖼️ │ ← Selected (blue border)
│ │
└─────────────────┘Multi-Selection
Keyboard shortcuts:
Ctrl/Cmd + Click: Add to selectionShift + Click: Select rangeCtrl/Cmd + A: Select all visible
Selection toolbar:
┌────────────────────────────────────────────────────┐
│ 5 selected [Download] [Edit] [Delete] [Clear] │
└────────────────────────────────────────────────────┘Bulk Operations
Bulk Download
Download multiple images as ZIP:
- Select images
- Click Download
- Choose format (Original / Optimized)
- Download starts automatically
┌─────────────────────────────────────┐
│ Download Options │
├─────────────────────────────────────┤
│ Format: │
│ ● Original quality │
│ ○ Optimized (smaller files) │
├─────────────────────────────────────┤
│ Include: │
│ ☑ Metadata JSON │
│ ☐ Thumbnails │
├─────────────────────────────────────┤
│ [Download 5 images] │
└─────────────────────────────────────┘Bulk Delete
Delete multiple images:
- Select images
- Click Delete
- Confirm deletion
WARNING
Deletion is permanent. Images cannot be recovered.
Bulk Edit
Apply edits to multiple images:
- Select images (2-20)
- Click Edit
- Enter edit prompt
- Edits applied sequentially
Lightbox
Click an image to open the lightbox viewer:
┌────────────────────────────────────────────────────┐
│ [×] │
│ [←] 🖼️ Full Image [→] │
│ │
│ │
├────────────────────────────────────────────────────┤
│ Sunset over mountains with dramatic clouds │
│ 1024 × 768 • 2.3 MB • Generated │
│ │
│ [Download] [Edit] [Copy URL] [Delete] │
└────────────────────────────────────────────────────┘Lightbox Navigation
| Key | Action |
|---|---|
← / → | Previous / Next image |
Esc | Close lightbox |
D | Download current image |
E | Open in Composer for editing |
I | Toggle info panel |
Info Panel
View detailed metadata:
┌─────────────────────────────────────┐
│ Image Details │
├─────────────────────────────────────┤
│ ID: 342 │
│ Created: Jan 15, 2024 14:32 │
│ Session: sess_abc123 │
│ Operation: generate │
│ │
│ Dimensions: 1024 × 768 │
│ Size: 2.3 MB │
│ Format: WebP │
│ Aspect Ratio: landscape │
│ │
│ Model: gemini-flash-image │
│ SynthID: Yes │
├─────────────────────────────────────┤
│ Prompt: │
│ "sunset over mountains with │
│ dramatic clouds, golden hour" │
├─────────────────────────────────────┤
│ Edit History: │
│ • Original (this image) │
│ └─ Added birds (#343) │
│ └─ Made sky more vibrant (#344) │
└─────────────────────────────────────┘Actions
Per-Image Actions
Right-click or use action menu:
| Action | Description |
|---|---|
| Download | Download original image |
| Edit | Open in Composer |
| Copy URL | Copy public URL |
| View History | See edit lineage |
| Delete | Remove image |
Context Menu
┌─────────────────────────────┐
│ Download │
│ Edit in Composer │
│ ─────────────────────────── │
│ Copy Image URL │
│ Copy Thumbnail URL │
│ Copy Prompt │
│ ─────────────────────────── │
│ View Edit History │
│ View Session │
│ ─────────────────────────── │
│ Delete │
└─────────────────────────────┘Edit History
View the lineage of edited images:
┌─────────────────────────────────────────────────────┐
│ Edit History for #344 │
├─────────────────────────────────────────────────────┤
│ │
│ 🖼️ #342 (Original) │
│ │ "sunset over mountains" │
│ │ │
│ └─► 🖼️ #343 │
│ │ "add birds flying" │
│ │ │
│ └─► 🖼️ #344 (Current) │
│ "make sky more vibrant" │
│ │
│ Total edits: 2 │
│ [View #342] [View #343] [View #344] │
└─────────────────────────────────────────────────────┘Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl/Cmd + A | Select all visible |
Ctrl/Cmd + D | Download selected |
Ctrl/Cmd + F | Focus search |
Ctrl/Cmd + K | Toggle filters |
Delete | Delete selected |
Esc | Clear selection / Close lightbox |
G | Switch to Grid view |
M | Switch to Masonry view |
L | Switch to List view |
? | Show shortcuts help |
Pagination
Navigate large collections:
┌──────────────────────────────────────────────────────┐
│ Showing 1-50 of 1,523 images │
│ │
│ [◄ Prev] Page 1 of 31 [Next ►] │
│ │
│ Per page: [25 ▼] [50] [100] │
└──────────────────────────────────────────────────────┘Or use infinite scroll (configurable in settings).
Performance Tips
For Large Collections
- Use filters to narrow results before browsing
- Use list view for faster loading
- Reduce thumbnail size in settings
- Enable pagination instead of infinite scroll
Search Optimization
- Search is server-side for accuracy
- Use specific terms for faster results
- Combine filters with search for best performance
Responsive Design
The gallery adapts to screen size:
Desktop: Full grid with sidebar filters Tablet: Collapsible filters, smaller grid Mobile: Single column, bottom sheet filters
API Data Source
Gallery data comes from:
GET /api/images?search=query&limit=50&offset=0
GET /api/images/:id (for lightbox details)