creating-image-schemas

What this skill does

# JSON Prompting for Nano Banana Pro

This skill transforms natural language descriptions into structured JSON schemas that give precise control over image generation with Nano Banana Pro (Gemini 3 Pro Image).

## When to Use This Skill

Use this skill when the user wants to:

- Create **marketing images** with exact product specifications (product photography, hero shots)
- Design **UI mockups** with defined layouts, components, and color systems
- Build **infographics or diagrams** where process flows need to be clear
- Generate **data visualizations** where numbers and chart accuracy matter
- Create **social media graphics** with platform-specific dimensions and text overlays
- Generate images with **reproducibility** (same spec = same result)
- **Iterate on specific elements** without regenerating everything else
- Maintain **brand consistency** across multiple image generations

**Do NOT use this skill when:**

- The user wants creative exploration with surprise outcomes
- The user prefers vibes-based prompting
- A simple natural-language prompt would suffice
- The user hasn't defined what they actually want yet

## Core Concept: Handles

The power of JSON prompting is the **handle concept**. Every important element gets a stable identifier:

- **Scoped edits**: Change only the background, or only the lighting, without affecting other elements
- **Camera moves**: Same scene, different perspective
- **Themed variants**: Same structure, different visual styling
- **A/B testing**: Compare two versions that differ by exactly one variable

---

## The Five Schema Types

### 1. Marketing Image (`marketing_image`)

For product shots, hero images, brand photography, and advertising visuals.

**Key sections:**
- `subject`: Product type, name, variant, physical properties (finish, dimensions)
- `props`: Foreground, midground, and background objects with counts and positions
- `environment`: Surface material, background color/texture, atmosphere/mood
- `camera`: Angle, framing, focal length, depth of field
- `lighting`: Key light, fill light, rim light, color temperature
- `brand`: Logo assets, primary colors, forbidden changes
- `controls`: What can/cannot change during iteration

### 2. UI/UX (`ui_builder`)

For app screens, dashboards, websites, and interface mockups.

**Key sections:**
- `app`: Platform (web/mobile/desktop), fidelity level, viewport, theme
- `tokens`: Colors (hex values), typography, border radius, spacing scale
- `screens`: Array of screens with IDs, names, roles, and layout containers
- `components`: UI elements with screen assignment, container placement, and props
- `constraints`: Layout lock, theme lock, content lock

### 3. Diagram (`diagram_spec`)

For flowcharts, architecture diagrams, process maps, and system visualizations.

**Key sections:**
- `canvas`: Dimensions, unit, flow direction
- `semantics`: Diagram type, primary relationship, swimlanes
- `nodes`: Array of nodes with IDs, labels, roles, positions, styles
- `edges`: Connections between nodes with labels and arrow styles
- `groups`: Swimlanes or clusters for organizing nodes
- `constraints`: Layout lock, auto-routing permissions

### 4. Data Visualization (`data_viz`)

For charts, graphs, and statistical graphics where numerical accuracy is critical.

**Key sections:**
- `chart_type`: bar, line, pie, scatter, area, treemap, heatmap
- `data_series[]`: Arrays of data points with labels and values
- `axes`: X and Y axis configuration (labels, min/max, units, gridlines)
- `annotations`: Callouts, trend lines, data labels, highlights
- `style`: Colors, fonts, legend position
- `constraints`: Data values that must appear exactly as specified

### 5. Social Media Graphic (`social_graphic`)

For platform-specific social content with text overlays and brand elements.

**Key sections:**
- `platform`: Target platform (instagram_post, instagram_story, twitter_card, linkedin_post, youtube_thumbnail)
- `dimensions`: Auto-set based on platform or custom
- `background`: Solid color, gradient, image, or pattern
- `text_layers[]`: Headline, subhead, body, CTA with positions and styling
- `brand`: Logo placement, colors, fonts
- `style`: Visual tone (minimal, bold, playful, professional)

---

## Translator Workflow

### Step 1: Classify Intent

Determine the target schema from the user's description:

| User talks about... | Schema to use |
|---------------------|---------------|
| Product shots, hero images, brand photography, campaigns | `marketing_image` |
| Screens, buttons, dashboards, apps, navigation, mockups | `ui_builder` |
| Flows, processes, systems, nodes, boxes-and-arrows | `diagram_spec` |
| Charts, graphs, data, statistics, metrics, numbers | `data_viz` |
| Instagram, Twitter, LinkedIn, social posts, thumbnails | `social_graphic` |

If ambiguous, ask 1-2 short questions to disambiguate.

### Step 2: Gather Requirements

**For Marketing Images:**
- Main subject (product type, name, size)
- Props (and where: foreground, around base, background)
- Environment (surface, background, mood)
- Camera angle and framing
- Lighting direction and intensity
- Brand constraints (logos, colors, things that cannot change)

**For UI/UX:**
- Platform (web, mobile, desktop)
- Number of screens and their roles
- Layout areas (top nav, sidebar, content)
- Key components (charts, tables, forms, cards)
- Color scheme or brand guidelines

**For Diagrams:**
- Diagram type (flowchart, architecture, swimlane, mind map)
- Key nodes/steps
- Connections and labels
- Groupings or lanes
- Flow direction

**For Data Visualizations:**
- Chart type (bar, line, pie, scatter, etc.)
- Data series with actual values
- Axis labels and ranges
- Any annotations or callouts
- Whether exact numbers must appear in the output

**For Social Graphics:**
- Target platform (determines dimensions)
- Background style (solid, gradient, image)
- Text content (headline, subhead, CTA)
- Brand elements (logo, colors)
- Visual style/mood

### Step 3: Generate JSON

Build a complete JSON object with the appropriate root key. Ensure:
- All IDs are unique
- All references are valid
- Required fields are filled
- Output is valid JSON (no comments, no trailing commas)

### Step 4: Provide Next Steps

Tell the user:
1. Review the JSON to ensure it captures their intent
2. Copy the entire JSON
3. Open Nano Banana Pro (Gemini app with "Thinking" model, or Google AI Studio)
4. Paste with instruction: "Render this specification as a high-fidelity image"
5. Iterate by modifying specific fields and re-rendering

---

## Common Values Reference

**Camera angles:** `front`, `three_quarter_front`, `three_quarter_back`, `side`, `top_down`, `low_angle`, `overhead`

**Framing:** `extreme_close_up`, `close_up`, `medium_close`, `medium`, `medium_wide`, `wide`

**Lighting intensity:** `very_low`, `low`, `medium`, `high`, `very_high`

**Lighting direction:** `left`, `right`, `front`, `back`, `top`, `three_quarter_left`, `three_quarter_right`

**Surface materials:** `glossy`, `matte`, `marble`, `wood`, `concrete`, `fabric`, `metal`, `glass`

**UI fidelity:** `wireframe`, `low-fi`, `mid-fi`, `hi-fi`

**UI platforms:** `web`, `mobile`, `tablet`, `desktop`

**Diagram types:** `flowchart`, `architecture`, `sequence`, `swimlane`, `mindmap`, `org_chart`

**Node roles:** `start`, `end`, `process`, `decision`, `database`, `actor`, `note`

**Chart types:** `bar`, `horizontal_bar`, `line`, `area`, `pie`, `donut`, `scatter`, `bubble`, `treemap`, `heatmap`, `radar`

**Social platforms:** `instagram_post` (1080x1080), `instagram_story` (1080x1920), `twitter_card` (1200x675), `linkedin_post` (1200x627), `youtube_thumbnail` (1280x720), `facebook_post` (1200x630)

**Text positions:** `top_left`, `top_center`, `top_right`, `center_left`, `center`, `center_right`, `bottom_left`, `bottom_center`, `bottom_right`

---

## Complete Schema Examples

### Marketing Image Example

**Request:** "Hero shot for a lime seltzer brand called Aurora Lime. 12oz can on a reflective