plugin: nanobanana updated: 2026-01-20

Style Format Specification

Overview

Styles are single markdown files in the styles/ directory. The entire file content is prepended to the user's prompt.

File Location

{project}/
  styles/
    glass.md
    watercolor.md
    cyberpunk.md

Template Structure

# Style Name

{Overall description of the visual style. Be vivid and specific.
Include mood, atmosphere, key visual characteristics.}

## Color Palette
- Primary: {color} ({hex})
- Secondary: {color} ({hex})
- Background: {color} ({hex})
- Accents: {colors}

## Technical Notes
{Rendering style, lighting, materials, post-processing}

Example: Blue Glass 3D

# Blue Glass 3D Style

A photorealistic 3D render with blue glass material. Objects should have:
- Glossy, translucent blue glass surface
- Subtle reflections and refractions
- Solid black background
- Soft studio lighting from above-left
- Sharp shadows

## Color Palette
- Primary: Deep blue (#1a4b8c)
- Highlights: Light cyan (#7fdbff)
- Background: Pure black (#000000)

## Technical Notes
- Use ray-traced rendering appearance
- Include caustic light effects
- Maintain consistent material across objects

Usage

# Apply style to generation
uv run python main.py out.png "gear icon" --style styles/glass.md

# Combine with reference
uv run python main.py out.png "cube" --style styles/glass.md --ref prev.png

Style vs Reference

| Concept | Type | Purpose | |---------|------|---------| | Style | Text (.md) | Artistic direction via description | | Reference | Image | Visual example for consistency |

Both can be combined for best results.

Security Notes

Style files are validated for potential injection patterns:

No bash/shell code blocks
No variable expansion (${ })
No command substitution ($( ))
No shell operators (& | ; `)

Suspicious patterns generate warnings but don't block creation.

Writing Effective Styles

Be Specific: "Soft watercolor washes with visible paper texture"
Include Colors: Hex codes ensure consistency
Describe Mood: "Mysterious, slightly unsettling"
Technical Details: Lighting, camera angle, rendering style
Keep It Focused: One style per file