grimoire-wizard 0.3.1 → 0.4.0

package/examples/yaml/appstore-screenshot-wizard.yaml

@@ -0,0 +1,321 @@
+meta:
+  name: "App Store Screenshot Wizard"
+  description: "Generate beautiful AI-powered app store screenshots"
+  version: "1.0.0"
+  review: true
+
+theme:
+  preset: catppuccin
+
+steps:
+  # ── Generation Setup ──────────────────────────────────────────────
+
+  - id: generation-mode
+    type: select
+    group: "Generation Setup"
+    message: "What would you like to generate?"
+    default: app_store_screenshots
+    options:
+      - { value: app_store_screenshots, label: "App Store Screenshots", hint: "Device-framed marketing screenshots with store-specific dimensions" }
+      - { value: app_ui, label: "App UI Screens", hint: "Consistent app UI screens driven by a concept brief design system" }
+      - { value: web_ui, label: "Web UI Screens", hint: "SaaS dashboards, landing pages, and web application screens" }
+      - { value: design_system, label: "Design System Preview", hint: "Component and token showcase for visual consistency review" }
+
+  - id: platform-preset
+    type: select
+    group: "Generation Setup"
+    message: "Target platform"
+    when:
+      field: generation-mode
+      equals: app_store_screenshots
+    default: custom
+    options:
+      - { value: app_store, label: "Apple App Store", hint: "iPhone + iPad" }
+      - { value: google_play, label: "Google Play Store", hint: "Phone + Tablet" }
+      - { value: both, label: "Both Platforms", hint: "App Store + Google Play" }
+      - { value: custom, label: "Custom Selection", hint: "Choose devices manually" }
+
+  - id: providers
+    type: multiselect
+    group: "Generation Setup"
+    message: "Select AI providers"
+    min: 1
+    default: ["gemini"]
+    options:
+      - { value: gemini, label: "Gemini" }
+      - { value: openai, label: "OpenAI" }
+
+  # ── App Details ────────────────────────────────────────────────────
+
+  - id: app-name
+    type: text
+    group: "App Details"
+    message: "App name"
+    validate:
+      - rule: required
+      - rule: minLength
+        value: 1
+
+  - id: app-description
+    type: text
+    group: "App Details"
+    message: "Describe your app"
+    validate:
+      - rule: required
+      - rule: minLength
+        value: 10
+
+  # ── Visual Style ───────────────────────────────────────────────────
+
+  - id: visual-style
+    type: select
+    group: "Visual Style"
+    message: "Visual style"
+    default: auto
+    options:
+      - { value: auto, label: "Auto (AI picks best style)", hint: "Let the Creative Director choose" }
+      - { value: photorealistic, label: "Photorealistic" }
+      - { value: 3d-cartoon, label: "3D Cartoon" }
+      - { value: isometric, label: "Isometric" }
+      - { value: claymorphism, label: "Claymorphism" }
+      - { value: flat-2d, label: "Flat 2D" }
+      - { value: illustration, label: "Illustration" }
+      - { value: freestyle, label: "Freestyle (AI-selected)", hint: "AI picks the most distinctive style" }
+
+  # ── Content Settings ───────────────────────────────────────────────
+
+  - id: screenshot-count
+    type: number
+    group: "Content Settings"
+    message: "How many screenshots?"
+    default: 10
+    min: 1
+    max: 20
+
+  - id: reference-images
+    type: select
+    group: "Content Settings"
+    message: "Reference images for UI matching"
+    default: none
+    options:
+      - { value: none, label: "None", hint: "Generate UI from description only" }
+      - { value: single, label: "Single screenshot", hint: "Provide one reference image" }
+      - { value: folder, label: "Folder of screenshots", hint: "Multiple UI screenshots for 1:1 matching" }
+
+  - id: reference-image-path
+    type: text
+    group: "Content Settings"
+    message: "Path to screenshot image"
+    when:
+      field: reference-images
+      equals: single
+    placeholder: "/path/to/screenshot.png"
+    validate:
+      - rule: required
+
+  - id: reference-folder-path
+    type: text
+    group: "Content Settings"
+    message: "Path to folder with UI screenshots"
+    when:
+      field: reference-images
+      equals: folder
+    placeholder: "/path/to/screenshots/"
+    validate:
+      - rule: required
+
+  - id: design-reference
+    type: select
+    group: "Content Settings"
+    message: "Design reference"
+    default: none
+    options:
+      - { value: none, label: "None", hint: "AI picks its own creative direction" }
+      - { value: dribbble, label: "From dribbble-inspirations", hint: "Pick a professional design to match" }
+      - { value: custom, label: "Custom image path", hint: "Provide any image file as reference" }
+
+  - id: design-reference-path
+    type: text
+    group: "Content Settings"
+    message: "Path to design reference image"
+    when:
+      field: design-reference
+      equals: custom
+    placeholder: "/path/to/design-reference.png"
+    validate:
+      - rule: required
+
+  # ── Device Targets ─────────────────────────────────────────────────
+
+  - id: device-targets
+    type: multiselect
+    group: "Device Targets"
+    message: "Target devices"
+    when:
+      any:
+        - { field: platform-preset, equals: custom }
+        - { field: generation-mode, notEquals: app_store_screenshots }
+    min: 1
+    default: ["iphone"]
+    options:
+      - { value: iphone, label: "iPhone" }
+      - { value: ipad, label: "iPad" }
+      - { value: watch, label: "Apple Watch" }
+      - { value: android-phone, label: "Android Phone" }
+      - { value: android-tablet, label: "Android Tablet" }
+
+  # ── AI Models ──────────────────────────────────────────────────────
+
+  - id: gemini-image-model
+    type: select
+    group: "AI Models"
+    message: "Gemini image generation model"
+    when:
+      field: providers
+      includes: gemini
+    default: gemini-3.1-flash-image-preview
+    options:
+      - { value: gemini-3.1-flash-image-preview, label: "Flash (Fast & Cheap)", hint: "Near-Pro quality at ~$0.067/img" }
+      - { value: gemini-3-pro-image-preview, label: "Pro (Best Quality)", hint: "Top quality, 94% text accuracy — $0.134/img" }
+
+  - id: gemini-text-model
+    type: select
+    group: "AI Models"
+    message: "Gemini pipeline text model"
+    when:
+      field: providers
+      includes: gemini
+    default: gemini-2.5-flash
+    options:
+      - { value: gemini-2.5-flash, label: "Gemini Flash (Fast)", hint: "Fast pipeline stages, good quality" }
+      - { value: gemini-2.5-pro, label: "Gemini Pro (Best Prompts)", hint: "Higher quality prompt refinement" }
+      - { value: claude-sonnet-4-20250514, label: "Claude Sonnet 4 (Scoring)", hint: "Excellent visual judgment" }
+      - { value: claude-haiku-4-20250414, label: "Claude Haiku 4 (Fast Scoring)", hint: "Fast and cheap visual scoring" }
+
+  - id: openai-image-model
+    type: select
+    group: "AI Models"
+    message: "OpenAI image generation model"
+    when:
+      field: providers
+      includes: openai
+    default: gpt-image-1
+    options:
+      - { value: gpt-image-1, label: "GPT Image 1", hint: "OpenAI image generation model" }
+
+  - id: openai-text-model
+    type: select
+    group: "AI Models"
+    message: "OpenAI pipeline text model"
+    when:
+      field: providers
+      includes: openai
+    default: gpt-4o-mini
+    options:
+      - { value: gpt-4o, label: "GPT-4o", hint: "Advanced reasoning and generation" }
+      - { value: gpt-4o-mini, label: "GPT-4o Mini", hint: "Fast and efficient generation" }
+
+  # ── Marketing Copy ─────────────────────────────────────────────────
+
+  - id: headline-prefix
+    type: text
+    group: "Marketing Copy"
+    message: "Headline prefix above device"
+    placeholder: "Leave empty to omit"
+    default: ""
+    required: false
+
+  - id: cta-badge
+    type: text
+    group: "Marketing Copy"
+    message: "CTA badge text"
+    placeholder: "Leave empty for no badge"
+    default: ""
+    required: false
+
+  - id: badge-position
+    type: select
+    group: "Marketing Copy"
+    message: "Badge position"
+    when:
+      field: cta-badge
+      isNotEmpty: true
+    default: bottom-right
+    options:
+      - { value: bottom-right, label: "Bottom-right" }
+      - { value: bottom-left, label: "Bottom-left" }
+      - { value: top-right, label: "Top-right" }
+
+  # ── Localization ───────────────────────────────────────────────────
+
+  - id: want-locales
+    type: confirm
+    group: "Localization"
+    message: "Generate for multiple languages?"
+    default: false
+
+  - id: locales
+    type: multiselect
+    group: "Localization"
+    message: "Select target locales"
+    when:
+      field: want-locales
+      equals: true
+    min: 1
+    options:
+      - { value: en, label: "English" }
+      - { value: ja, label: "Japanese" }
+      - { value: de, label: "German" }
+      - { value: es, label: "Spanish" }
+      - { value: fr, label: "French" }
+      - { value: pt-BR, label: "Portuguese (Brazil)" }
+      - { value: ko, label: "Korean" }
+      - { value: zh-CN, label: "Chinese (Simplified)" }
+      - { value: it, label: "Italian" }
+      - { value: ar, label: "Arabic" }
+
+  # ── Advanced Options ───────────────────────────────────────────────
+
+  - id: advanced-options
+    type: multiselect
+    group: "Advanced Options"
+    message: "Advanced options"
+    required: false
+    options:
+      - { value: variations, label: "Style variations", hint: "Generate multiple style sets" }
+      - { value: mixed, label: "Mixed prompts", hint: "Different style per image" }
+      - { value: landscape, label: "Landscape orientation", hint: "2778x1284 instead of portrait" }
+
+  - id: variation-styles
+    type: multiselect
+    group: "Advanced Options"
+    message: "Select styles for variations"
+    when:
+      field: advanced-options
+      includes: variations
+    min: 1
+    options:
+      - { value: photorealistic, label: "Photorealistic" }
+      - { value: 3d-cartoon, label: "3D Cartoon" }
+      - { value: isometric, label: "Isometric" }
+      - { value: claymorphism, label: "Claymorphism" }
+      - { value: flat-2d, label: "Flat 2D" }
+      - { value: illustration, label: "Illustration" }
+
+  # ── Confirmation ───────────────────────────────────────────────────
+
+  - id: confirm-generate
+    type: confirm
+    group: "Confirmation"
+    message: "Start generation?"
+    default: true
+
+  - id: save-template-name
+    type: text
+    group: "Confirmation"
+    message: "Save as template? (enter name or leave empty to skip)"
+    default: ""
+    required: false
+
+output:
+  format: json

package/examples/yaml/appstore-upload.yaml

@@ -0,0 +1,84 @@
+meta:
+  name: "App Store Connect Upload"
+  description: "Upload screenshots to App Store Connect"
+  version: "1.0.0"
+
+theme:
+  preset: monokai
+
+steps:
+  - id: run-id
+    type: text
+    group: "Run Selection"
+    message: "Run ID (from generation results)"
+    validate:
+      - rule: required
+    placeholder: "e.g., 2024-01-15T10-30-00"
+
+  - id: asc-info-note
+    type: note
+    group: "ASC Credentials"
+    message: "App Store Connect API Key"
+    description: "You need an App Store Connect API key. Create one at https://appstoreconnect.apple.com/access/api"
+
+  - id: issuer-id
+    type: text
+    group: "ASC Credentials"
+    message: "Issuer ID"
+    validate:
+      - rule: required
+    placeholder: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+
+  - id: key-id
+    type: text
+    group: "ASC Credentials"
+    message: "Key ID"
+    validate:
+      - rule: required
+    placeholder: "XXXXXXXXXX"
+
+  - id: key-path
+    type: path
+    group: "ASC Credentials"
+    message: "Path to API key (.p8 file)"
+    validate:
+      - rule: required
+    placeholder: "~/.appstoreconnect/AuthKey_XXXXXXXXXX.p8"
+
+  - id: app-id
+    type: text
+    group: "App Details"
+    message: "App ID"
+    validate:
+      - rule: required
+    placeholder: "e.g., 1234567890"
+
+  - id: localization-id
+    type: text
+    group: "App Details"
+    message: "Localization ID"
+    validate:
+      - rule: required
+    placeholder: "e.g., en-US"
+
+  - id: display-type
+    type: select
+    group: "App Details"
+    message: "Display type"
+    options:
+      - { value: APP_IPHONE_67, label: 'iPhone 6.7"' }
+      - { value: APP_IPHONE_65, label: 'iPhone 6.5"' }
+      - { value: APP_IPAD_PRO_129, label: 'iPad Pro 12.9"' }
+      - { value: APP_IPAD_PRO_3GEN_129, label: 'iPad Pro 12.9" (3rd Gen)' }
+      - { value: APP_APPLE_WATCH_ULTRA, label: "Apple Watch Ultra" }
+      - { value: APP_APPLE_WATCH_SERIES_7, label: "Apple Watch Series 7" }
+    default: APP_IPHONE_67
+
+  - id: confirm-upload
+    type: confirm
+    group: "Confirmation"
+    message: "Upload screenshots to App Store Connect?"
+    default: true
+
+output:
+  format: json

package/examples/yaml/batch-generate.yaml

@@ -0,0 +1,156 @@
+meta:
+  name: "Batch Generation Setup"
+  description: "Configure batch generation for multiple apps"
+  version: "1.0.0"
+
+theme:
+  preset: nord
+
+steps:
+  - id: shared-image-model
+    type: select
+    group: "Shared Settings"
+    message: "Default image generation model"
+    options:
+      - { value: gemini-3.1-flash-image-preview, label: "Flash (Fast & Cheap)", hint: "Near-Pro quality at ~$0.067/img" }
+      - { value: gemini-3-pro-image-preview, label: "Pro (Best Quality)", hint: "Top quality, 94% text accuracy" }
+    default: gemini-3.1-flash-image-preview
+
+  - id: shared-text-model
+    type: select
+    group: "Shared Settings"
+    message: "Default text model"
+    options:
+      - { value: gemini-2.5-flash, label: "Gemini Flash (Fast)" }
+      - { value: gemini-2.5-pro, label: "Gemini Pro (Best Prompts)" }
+    default: gemini-2.5-flash
+
+  - id: shared-count
+    type: number
+    group: "Shared Settings"
+    message: "Default screenshot count per app"
+    default: 10
+    min: 1
+    max: 50
+
+  - id: shared-providers
+    type: multiselect
+    group: "Shared Settings"
+    message: "Default providers"
+    options:
+      - { value: gemini, label: "Gemini" }
+      - { value: openai, label: "OpenAI" }
+    default: ["gemini"]
+    min: 1
+
+  - id: shared-device-targets
+    type: multiselect
+    group: "Shared Settings"
+    message: "Default device targets"
+    options:
+      - { value: iphone, label: "iPhone" }
+      - { value: ipad, label: "iPad" }
+      - { value: watch, label: "Apple Watch" }
+      - { value: android-phone, label: "Android Phone" }
+      - { value: android-tablet, label: "Android Tablet" }
+    default: ["iphone"]
+    min: 1
+
+  - id: app-1-note
+    type: note
+    group: "App 1"
+    message: "First App Configuration"
+    description: "Configure the first app in the batch"
+
+  - id: app-1-name
+    type: text
+    group: "App 1"
+    message: "App 1 name"
+    validate:
+      - rule: required
+
+  - id: app-1-description
+    type: text
+    group: "App 1"
+    message: "App 1 description"
+    validate:
+      - rule: required
+      - rule: minLength
+        value: 10
+
+  - id: app-1-visual-style
+    type: select
+    group: "App 1"
+    message: "App 1 visual style"
+    options:
+      - { value: auto, label: "Auto (AI picks)" }
+      - { value: photorealistic, label: "Photorealistic" }
+      - { value: 3d-cartoon, label: "3D Cartoon" }
+      - { value: isometric, label: "Isometric" }
+      - { value: claymorphism, label: "Claymorphism" }
+      - { value: flat-2d, label: "Flat 2D" }
+      - { value: illustration, label: "Illustration" }
+    default: auto
+
+  - id: app-1-count
+    type: number
+    group: "App 1"
+    message: "App 1 screenshot count (leave default to use shared)"
+    default: 10
+    min: 1
+    max: 50
+
+  - id: add-app-2
+    type: confirm
+    group: "App 2"
+    message: "Add a second app to the batch?"
+    default: false
+
+  - id: app-2-name
+    type: text
+    group: "App 2"
+    message: "App 2 name"
+    when:
+      field: add-app-2
+      equals: true
+    validate:
+      - rule: required
+
+  - id: app-2-description
+    type: text
+    group: "App 2"
+    message: "App 2 description"
+    when:
+      field: add-app-2
+      equals: true
+    validate:
+      - rule: required
+      - rule: minLength
+        value: 10
+
+  - id: app-2-visual-style
+    type: select
+    group: "App 2"
+    message: "App 2 visual style"
+    when:
+      field: add-app-2
+      equals: true
+    options:
+      - { value: auto, label: "Auto (AI picks)" }
+      - { value: photorealistic, label: "Photorealistic" }
+      - { value: 3d-cartoon, label: "3D Cartoon" }
+      - { value: isometric, label: "Isometric" }
+      - { value: claymorphism, label: "Claymorphism" }
+      - { value: flat-2d, label: "Flat 2D" }
+      - { value: illustration, label: "Illustration" }
+    default: auto
+
+  - id: confirm-batch
+    type: confirm
+    group: "Confirmation"
+    message: "Generate batch config file?"
+    default: true
+
+output:
+  format: json
+  path: batch-config.json