.codex-plugin/plugin.json

{
  "name": "app-listing-screenshots",
  "version": "0.3.14",
  "description": "Create screenshot series on the App Listing Screenshots server. Show previews and download all PNGs in a ZIP.",
  "author": {
    "name": "Ben Baler"
  },
  "skills": "./skills",
  "interface": {
    "displayName": "App Listing Screenshots",
    "shortDescription": "App Store & Play screenshots",
    "longDescription": "Create App Store and Google Play screenshots right in ChatGPT—without local rendering setup. Turn one or more captures into a single image or a coordinated series with headlines, backgrounds, and device frames. Choose supported store sizes or custom dimensions, preview the result, and download full-resolution PNGs in one ZIP. Try the workflow with a sample if you do not have captures ready. This creates image files; it does not publish to store accounts. Source images, projects and new series exports remain stored until you request deletion. New series download links have no automatic expiry.",
    "developerName": "Ben Baler",
    "category": "Creativity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://listingframe.benbaler.workers.dev/",
    "supportURL": "https://listingframe.benbaler.workers.dev/support",
    "privacyPolicyURL": "https://listingframe.benbaler.workers.dev/privacy",
    "termsOfServiceURL": "https://listingframe.benbaler.workers.dev/terms",
    "logo": "./assets/icon.png",
    "composerIcon": "./assets/icon.png",
    "defaultPrompt": [
      "Make three App Store screenshots from the habit tracker sample. Add headlines, show a preview, and give me the PNG ZIP.",
      "Make a Google Play feature graphic from the sample at 1024×500. Add a headline, preview it, and give me the PNG ZIP."
    ],
    "screenshots": [
      "./assets/series-preview.png",
      "./assets/single-preview.png"
    ],
    "brandColor": "#7C5CE5"
  },
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "Fixes previews when the host only supplies structured output. Adds persistent PNG and ZIP links and keeps downloads available when preview images are missing."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use the attached public sample capture to create one portrait store screenshot. Confirm that the returned series contains one slide and the export includes its preview and ZIP.",
              "prompt": "Using the attached habit tracker capture, create one 1080×1920 store screenshot with a blue background and the headline Build Better Habits. Show me the preview and give me the ZIP.",
              "file_attachment_urls": [
                "https://listingframe.benbaler.workers.dev/examples/habit-tracker.png"
              ],
              "tools_triggered": "create_screenshot_series, export_screenshot_series",
              "expected_behavior": "The tools create one slide using the supplied image and requested design. export_screenshot_series returns the original 1080×1920 PNG as a separate image block and a ZIP link; the MCP Apps component shows the image and a ZIP link containing that PNG."
            },
            {
              "description": "Create a coordinated three-slide series using the bundled sample image and distinct per-slide headlines and backgrounds.",
              "prompt": "Use the bundled habit tracker sample to make three 1080×1920 screenshots titled Build Better Habits, Track Every Day, and See Your Progress, with blue, purple, and green backgrounds. Show the preview and give me the ZIP.",
              "tools_triggered": "create_screenshot_series, export_screenshot_series",
              "expected_behavior": "The tools create three ordered slides from the bundled sample with the requested headlines and backgrounds. The export returns three ordered 1080×1920 PNG image blocks and a ZIP link; the MCP Apps component visibly shows three separate images and the ZIP link."
            },
            {
              "description": "Create a landscape Google Play feature graphic from the attached public sample capture.",
              "prompt": "Use the attached habit tracker capture to make a 1024×500 Google Play feature graphic with the headline Build Better Habits. Show the preview and give me the ZIP.",
              "file_attachment_urls": [
                "https://listingframe.benbaler.workers.dev/examples/habit-tracker.png"
              ],
              "tools_triggered": "list_screenshot_options, create_screenshot_series, export_screenshot_series",
              "expected_behavior": "The options tool confirms supported dimensions and the create/export tools return one original 1024×500 PNG image block and a ZIP link. The MCP Apps component visibly shows the image and ZIP link. The assistant does not claim it submitted the image to Google Play."
            },
            {
              "description": "Render two slides from the same supplied capture with distinct titles and verify their order in the returned series.",
              "prompt": "Using the attached habit tracker capture, create two 1080×1920 screenshots in this order: Start Today, then Keep Going. Use a blue background for the first and a purple background for the second. Show the preview and give me the ZIP.",
              "file_attachment_urls": [
                "https://listingframe.benbaler.workers.dev/examples/habit-tracker.png"
              ],
              "tools_triggered": "create_screenshot_series, export_screenshot_series",
              "expected_behavior": "The tools create two ordered slides using the attached capture and per-slide design settings. The export returns two full-resolution PNG image blocks in the requested order and a ZIP link; the MCP Apps component visibly shows two separate images and the ZIP link."
            },
            {
              "description": "Ask for supported sizes, then create and export one screenshot at a supported custom portrait size.",
              "prompt": "What screenshot sizes can you make? Use the bundled sample to create one 1242×2688 screenshot with the headline Start Today, then show the preview and give me the ZIP.",
              "tools_triggered": "list_screenshot_options, create_screenshot_series, export_screenshot_series",
              "expected_behavior": "The options tool reports the current schema and supported dimensions. If 1242×2688 is supported, create/export returns one original PNG image block at that size and a ZIP link; the MCP Apps component visibly shows the image and ZIP link. Otherwise the assistant asks the user to choose a supported size without claiming a render succeeded."
            }
          ],
          "negative": [
            {
              "description": "The plugin does not submit screenshots to store accounts. Explain this limitation without invoking screenshot tools or claiming a submission.",
              "prompt": "Submit these screenshots to App Store Connect for me."
            },
            {
              "description": "The plugin does not provide keyword-volume, ranking, or market research. Explain the limitation without invoking screenshot tools or inventing metrics.",
              "prompt": "Can App Listing Screenshots provide the highest-volume App Store keywords for my app and predict how much my ranking will improve?"
            },
            {
              "description": "The plugin does not modify application source code. Explain the limitation without invoking screenshot tools or claiming code was changed.",
              "prompt": "Edit my app's source code so its actual onboarding screen looks like this mockup."
            }
          ]
        },
        "demo_recording_url": "https://listingframe.benbaler.workers.dev/plugin-demo-0.3.11.mp4",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. Screenshot rendering and ZIP export are available without payment."
      }
    }
  }
}