
Design App Store and Google Play screenshots with your AI agent in the AppScreenStudio editor.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer token from the AppScreenStudio editor Connect button
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add an image layer to a card. src is an image URL, such as one from upload_image or list_library. Pass spriteCoordinate to crop one pose of a sprite sheet.
Layer center, in percent of the card width from the card center. 50 is the right edge.
Layer center, in percent of the card height from the card center. 50 is the bottom edge.
CSS pixels on the 500px-tall card.
CSS pixels on the 500px-tall card.
Degrees, clockwise.
Crop rectangle on the source image, in source pixels. Use a pose from list_library.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add an image layer to a card. src is an image URL, such as one from upload_image or list_library. Pass spriteCoordinate to crop one pose of a sprite sheet.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| src* | string | |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| rotation | number | Degrees, clockwise. |
| screenshotId* | string | |
| spriteCoordinate | object | Crop rectangle on the source image, in source pixels. Use a pose from list_library. |
{
"type": "object",
"required": [
"screenshotId",
"src"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"src": {
"type": "string"
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"rotation": {
"type": "number",
"description": "Degrees, clockwise."
},
"screenshotId": {
"type": "string"
},
"spriteCoordinate": {
"type": "object",
"required": [
"x",
"y",
"width",
"height"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"description": "Crop rectangle on the source image, in source pixels. Use a pose from list_library."
}
},
"additionalProperties": false
}Add a box layer to a card. Pass html to draw a custom card: width and height set its layout box, and every visible style goes in the html, since backgroundColor and borderRadius only style plain boxes without html. A style element stays inside the card.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| html | string | Custom card HTML, up to 8000 characters. Image src and CSS url() must be URLs from upload_image with type asset; data: URLs are rejected. font-family can use built-in editor fonts and fonts added with add_project_font; @import and external stylesheets are rejected. Mark everything a user may want to change, so the editor's Content panel can edit it and AI translation translates it: data-edit="text" on each element whose words change (headlines, labels, list rows, numbers; put it on the innermost element holding the words; line breaks are <br>), data-edit="image" on an <img> or on an element with a CSS background-image, data-edit-color="--accent" on an element whose style sets that CSS variable (use it as var(--accent); comma-separate several), data-edit-list on a container whose direct children are repeatable items (rows, bullets, cards), with data-max (default 12) and data-min (default 1). data-label names a field or list in the panel. Text in unmarked elements is not translated. |
| layer | string | front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes. |
| scale |
Add another phone to a screenshot card in the open editor. It uses the platform set's device frame and starts next to the main phone with its size, rotation, and shadow. Set imageUrl to an image URL (upload_image with type screenshot). Extra phones paint above the main phone, in the order they were added. Returns phoneId.
| Argument | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard. |
Add a platform set to the open project.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| platform* | string |
{
"type": "object",
"required": [
"platform"
],
"properties": {
"name": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"android",
"social"
],
"type": "string"
}
},
"additionalProperties": false
}Add a Google Fonts family to the open project. Then use it as fontFamily on text layers or as font-family in card html. Built-in editor fonts need no adding.
| Argument | Type | Description |
|---|---|---|
| family* | string | Exact family name from search_google_fonts, such as Caveat. |
{
"type": "object",
"required": [
"family"
],
"properties": {
"family": {
"type": "string",
"description": "Exact family name from search_google_fonts, such as Caveat."
}
},
"additionalProperties": false
}Add a card to the end of a platform set. The card is not blank: the set's first three cards get the template's sample texts and phone placement (sometimes a hidden or tilted phone), and later cards copy every layer of the set's last card without its phone image. Returns the ids of those layers so you can update or remove them.
| Argument | Type | Description |
|---|---|---|
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId"
],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Add a text layer to a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| align | string | |
| color | string | CSS color, such as #ffffff |
| content* | string | |
| fontSize | number | Font size in CSS pixels on the 500px-tall editor canvas. |
| rotation | number | |
| fontFamily | string | Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font. |
| fontWeight | string | |
| lineHeight | number | Multiplier of the font size |
| borderColor |
Add up to 5 languages by translating the open language with the same AI localize flow as the editor. Translates iOS and Android screenshot text and the store listing. Social screenshot text is copied unchanged. Spends credits. Does not switch the open language. Fails when the account cannot spend credits or a code is already on the project.
| Argument | Type | Description |
|---|---|---|
| languages* | array | Language codes to add, 1 to 5 unique codes. Examples: tr, de, ja, zh-Hans, pt-BR, es-419, en-GB. |
{
"type": "object",
"required": [
"languages"
],
"properties": {
"languages": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "Language codes to add, 1 to 5 unique codes. Examples: tr, de, ja, zh-Hans, pt-BR, es-419, en-GB."
}
},
"additionalProperties": false
}Return one JPEG of every card in a platform set side by side, as the editor renders them. Use it to check your edits. Defaults to the first platform set.
| Argument | Type | Description |
|---|---|---|
| platformSetId | string |
{
"type": "object",
"required": [],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Copy a screenshot onto another platform set.
| Argument | Type | Description |
|---|---|---|
| screenshotId* | string | |
| targetPlatformSetId* | string |
{
"type": "object",
"required": [
"screenshotId",
"targetPlatformSetId"
],
"properties": {
"screenshotId": {
"type": "string"
},
"targetPlatformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Duplicate a screenshot and insert the copy immediately after it.
| Argument | Type | Description |
|---|---|---|
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Generate an asset sprite with AI and save it to the account library. Spends credits. Returns imageUrl and poses like get_sprite, with a preview of each pose. Does not place it on a card.
| Argument | Type | Description |
|---|---|---|
| prompt | string | What to draw, up to 2000 characters. |
| quality | string | |
| referenceUrl | string | Optional https image URL used as a visual reference. |
{
"type": "object",
"required": [],
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters."
},
"quality": {
"enum": [
"medium",
"high"
],
"type": "string"
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"additionalProperties": false
}Generate an AI background for one card. Spends credits.
| Argument | Type | Description |
|---|---|---|
| prompt | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"prompt": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Generate a mascot sprite with AI and save it to the account library. Spends credits. Returns imageUrl and poses like get_sprite, with a preview of each pose. Does not place it on a card.
| Argument | Type | Description |
|---|---|---|
| prompt | string | What to draw, up to 2000 characters. Optional when presetId is set. |
| quality | string | |
| presetId | string | |
| referenceUrl | string | Optional https image URL used as a visual reference. |
{
"type": "object",
"required": [],
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters. Optional when presetId is set."
},
"quality": {
"enum": [
"medium",
"high"
],
"type": "string"
},
"presetId": {
"enum": [
"cute_animal",
"robot",
"fantasy_character",
"business_mascot",
"energy_character",
"space_character",
"gaming_character",
"creative_character"
],
"type": "string"
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"additionalProperties": false
}Read one platform of the open editor. Pass platform or platformSetId to include that set's screenshots. With no argument, a project with one platform set returns that set. A project with more than one set returns the set directory and screenshotsOmitted, without screenshot bodies. Call again with platform or an id from that directory.
| Argument | Type | Description |
|---|---|---|
| platform | string | Open every set of this platform. Use this when you know the store and not the set id. |
| platformSetId | string | Open this set. Ids come from a snapshot that omitted screenshots. |
{
"type": "object",
"required": [],
"properties": {
"platform": {
"enum": [
"ios",
"android",
"social"
],
"type": "string",
"description": "Open every set of this platform. Use this when you know the store and not the set id."
},
"platformSetId": {
"type": "string",
"description": "Open this set. Ids come from a snapshot that omitted screenshots."
}
},
"additionalProperties": false
}Return one saved asset or mascot in the same shape as a list_library item, including spriteSheet and poses. Also returns one image of each pose with its index drawn beside it.
| Argument | Type | Description |
|---|---|---|
| imageId* | string |
{
"type": "object",
"required": [
"imageId"
],
"properties": {
"imageId": {
"type": "string"
}
},
"additionalProperties": false
}List assets or mascots saved on this account (not screenshots or backgrounds). Items with spriteSheet true have poses, crop rectangles for add_asset spriteCoordinate. Also returns one image of up to 10 items with each id beside its picture.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| page | number | Page number, starting at 1. Defaults to 1. |
| limit | number | Page size, 1 to 50. Defaults to 20. Mascots are capped at 10. |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"asset",
"mascot"
],
"type": "string"
},
"page": {
"type": "number",
"description": "Page number, starting at 1. Defaults to 1."
},
"limit": {
"type": "number",
"description": "Page size, 1 to 50. Defaults to 20. Mascots are capped at 10."
}
},
"additionalProperties": false
}Move a screenshot left or right within its platform set.
| Argument | Type | Description |
|---|---|---|
| direction* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"direction"
],
"properties": {
"direction": {
"enum": [
"left",
"right"
],
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Rate how well these MCP tools worked for the task you just finished, from 1 to 5 stars. Call it once per task.
| Argument | Type | Description |
|---|---|---|
| stars* | integer | |
| comment | string |
{
"type": "object",
"required": [
"stars"
],
"properties": {
"stars": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"comment": {
"type": "string"
}
},
"additionalProperties": false
}Redo the last undone edit in the open editor.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Remove an image layer from a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| assetId* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"assetId"
],
"properties": {
"assetId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Remove a box layer from a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| divId* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"divId"
],
"properties": {
"divId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Remove an extra phone added with add_phone.
| Argument | Type | Description |
|---|---|---|
| phoneId* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"phoneId"
],
"properties": {
"phoneId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Remove an extra platform set. The first set of each platform stays.
| Argument | Type | Description |
|---|---|---|
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId"
],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Remove a screenshot from the open editor.
| Argument | Type | Description |
|---|---|---|
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Remove a text layer from a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| textId* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"textId"
],
"properties": {
"textId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Rename the open project.
| Argument | Type | Description |
|---|---|---|
| name* | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"additionalProperties": false
}Move a layer one step forward or backward among layers of the same kind. It cannot move a layer across kinds: back to front, cards always paint back divs, phones, image layers, front divs, then texts.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| direction* | string | |
| elementId* | string | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"elementId",
"kind",
"direction"
],
"properties": {
"kind": {
"enum": [
"text",
"asset",
"div"
],
"type": "string"
},
"direction": {
"enum": [
"forward",
"backward"
],
"type": "string"
},
"elementId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Report a bug, an unexpected tool result, or a suggestion about these MCP tools, when you notice one.
| Argument | Type | Description |
|---|---|---|
| kind* | string | |
| message* | string | |
| toolName | string |
{
"type": "object",
"required": [
"kind",
"message"
],
"properties": {
"kind": {
"enum": [
"bug",
"unexpected",
"suggestion"
],
"type": "string"
},
"message": {
"type": "string"
},
"toolName": {
"type": "string"
}
},
"additionalProperties": false
}Search Google Fonts by family name, category, or both. usable is true when the project can already use the family: a built-in editor font or one added with add_project_font.
| Argument | Type | Description |
|---|---|---|
| limit | number | 1 to 50. Defaults to 20. |
| query | string | Part of a family name, such as caveat or mono. |
| category | string |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "1 to 50. Defaults to 20."
},
"query": {
"type": "string",
"description": "Part of a family name, such as caveat or mono."
},
"category": {
"enum": [
"Sans Serif",
"Serif",
"Display",
"Handwriting",
"Monospace"
],
"type": "string"
}
},
"additionalProperties": false
}Set the device of a platform set. iOS sets take iphone-13-pro, iphone-13-pro-max, iphone-15-pro, iphone-15-pro-max, iphone-17-pro, iphone-17-pro-max, iphone-18-pro, iphone-18-pro-max, iphone-duo, borderless-frame, ipad-pro-12, ipad-pro-13, macbook-air-13, macbook-air-15, macbook-pro-14, macbook-pro-16. Android sets take pixel-8-pro, galaxy-s24-ultra, galaxy-s26-ultra, galaxy-tab-s10, android-borderless-frame. Social sets take any of them. borderless-frame and android-borderless-frame show the screenshot without a phone frame. macbook-air-13, macbook-air-15, macbook-pro-14, macbook-pro-16 are MacBooks: HyperRealistic 3D only, the screenshot fills the display (a 16:10 Mac screenshot loses a sliver at the sides), the lid is set with foldAmount.
| Argument | Type | Description |
|---|---|---|
| deviceId* | string | |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"deviceId"
],
"properties": {
"deviceId": {
"enum": [
"iphone-13-pro",
"iphone-13-pro-max",
"iphone-15-pro",
"iphone-15-pro-max",
"iphone-17-pro",
"iphone-17-pro-max",
"iphone-18-pro",
"iphone-18-pro-max",
"iphone-duo",
"borderless-frame",
"ipad-pro-12",
"ipad-pro-13",
"macbook-air-13",
"macbook-air-15",
"macbook-pro-14",
"macbook-pro-16",
"pixel-8-pro",
"galaxy-s24-ultra",
"galaxy-s26-ultra",
"galaxy-tab-s10",
"android-borderless-frame"
],
"type": "string"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Switch the open editor to a language that already exists on the project.
| Argument | Type | Description |
|---|---|---|
| lang* | string |
{
"type": "object",
"required": [
"lang"
],
"properties": {
"lang": {
"type": "string"
}
},
"additionalProperties": false
}Link or unlink matching text layers across platform sets.
| Argument | Type | Description |
|---|---|---|
| enabled* | boolean |
{
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"additionalProperties": false
}Set the device color of a platform set. On a HyperRealistic (threeDFrame) set the device shows only its real finishes: pass one of the set's deviceColors ids (see the snapshot); a generic color (black, white, orange, silver, space-gray, blue, purple, red, green) picks the closest real finish.
| Argument | Type | Description |
|---|---|---|
| color* | string | A generic color (black, white, orange, silver, space-gray, blue, purple, red, green) or, on a HyperRealistic set, a deviceColors id. |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"color"
],
"properties": {
"color": {
"type": "string",
"description": "A generic color (black, white, orange, silver, space-gray, blue, purple, red, green) or, on a HyperRealistic set, a deviceColors id."
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Set or clear the project background image. Pass an empty imageUrl to clear it.
| Argument | Type | Description |
|---|---|---|
| blur | number | |
| imageUrl* | string |
{
"type": "object",
"required": [
"imageUrl"
],
"properties": {
"blur": {
"enum": [
0,
1,
2,
3
],
"type": "number"
},
"imageUrl": {
"type": "string"
}
},
"additionalProperties": false
}Enable or disable the realistic device frame on a platform set. With threeD true the frame is a 3D device model (HyperRealistic) that also takes rotationX, rotationY, and rotationZ. 3D works on every device except borderless-frame and android-borderless-frame.
| Argument | Type | Description |
|---|---|---|
| threeD | boolean | 3D device model instead of the flat realistic frame. Requires enabled true. |
| enabled* | boolean | |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"enabled"
],
"properties": {
"threeD": {
"type": "boolean",
"description": "3D device model instead of the flat realistic frame. Requires enabled true."
},
"enabled": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Set the pixel size of a platform set.
| Argument | Type | Description |
|---|---|---|
| width* | number | |
| height* | number | |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"width",
"height"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Show or hide the notch on a platform set.
| Argument | Type | Description |
|---|---|---|
| show* | boolean | |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"show"
],
"properties": {
"show": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Enable or disable the squircle frame on a platform set.
| Argument | Type | Description |
|---|---|---|
| enabled* | boolean | |
| platformSetId* | string |
{
"type": "object",
"required": [
"platformSetId",
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}Set the template of the open project.
| Argument | Type | Description |
|---|---|---|
| templateId* | string |
{
"type": "object",
"required": [
"templateId"
],
"properties": {
"templateId": {
"enum": [
"minimal",
"gradient",
"geometric",
"wave",
"glass",
"connected"
],
"type": "string"
}
},
"additionalProperties": false
}Undo the last edit in the open editor.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}Update an image layer on a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| src | string | |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| assetId* | string | |
| rotation | number | |
| screenshotId* | string |
{
"type": "object",
"required": [
"screenshotId",
"assetId"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"src": {
"type": "string"
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"assetId": {
"type": "string"
},
"rotation": {
"type": "number"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}Update a box layer on a card.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| html | string | New card HTML, with the same rules as add_div html. Empty string clears the card. |
| divId* | string | |
| layer | string | front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes. |
| scale | number | Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size. |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| opacity | number | |
| rotationX |
Update an extra phone added with add_phone. Takes the same phone fields as update_screenshot. The main phone is edited with update_screenshot.
| Argument | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| phoneId* | string | |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard. |
Update a card and its main phone: background, phone placement and app screen, pattern, fade, or shadow. imageUrl is the app screen inside the phone (upload_image with type screenshot). The phone model is chosen per platform set with set_device.
| Argument | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard. |
Update App Store or Google Play listing fields for the current language. Does not generate copy. Returns the names of the fields written.
| Argument | Type | Description |
|---|---|---|
| appStore | object | |
| googlePlay | object |
{
"type": "object",
"required": [],
"properties": {
"appStore": {
"type": "object"
},
"googlePlay": {
"type": "object"
}
},
"additionalProperties": false
}Update one color of the open project's template. colorId must be one of the current template's colors: minimal (bg), gradient (from, via, to), geometric (bg, circle1, circle2), wave (from, to, wave), glass (from, to), connected (bg, dots). value is a CSS color such as #22c55e.
| Argument | Type | Description |
|---|---|---|
| value* | string | |
| colorId* | string |
{
"type": "object",
"required": [
"colorId",
"value"
],
"properties": {
"value": {
"type": "string"
},
"colorId": {
"type": "string"
}
},
"additionalProperties": false
}Update a text layer on a screenshot in the open editor.
| Argument | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| align | string | |
| color | string | CSS color, such as #ffffff |
| textId* | string | |
| content | string | |
| fontSize | number | Font size in CSS pixels on the 500px-tall editor canvas. |
| rotation | number | |
| fontFamily | string | Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font. |
| fontWeight | string | |
| lineHeight |
Prepare an image upload for the open project. Returns a one-time uploadUrl. POST the image as multipart form field "file" to that URL. The response JSON url is the stored image. Use it with update_screenshot imageUrl, add_asset src, set_project_background, or img src and CSS url() inside add_div or update_div html. For card images, use type asset. The link works once; if the POST fails, call this tool again. Pass base64 only when you cannot make that HTTP request.
| Argument | Type | Description |
|---|---|---|
| type* | string | |
| base64 | string | Optional raw base64 or data URL. Omit this and POST the file to uploadUrl. |
| filename* | string | File name, 1 to 120 characters, no path. Use a png, jpg, jpeg, or webp extension. For type asset, svg is also allowed. |
{
"type": "object",
"required": [
"type",
"filename"
],
"properties": {
"type": {
"enum": [
"screenshot",
"asset",
"background"
],
"type": "string"
},
"base64": {
"type": "string",
"description": "Optional raw base64 or data URL. Omit this and POST the file to uploadUrl."
},
"filename": {
"type": "string",
"description": "File name, 1 to 120 characters, no path. Use a png, jpg, jpeg, or webp extension. For type asset, svg is also allowed."
}
},
"additionalProperties": false
}| number |
| Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size. |
| width* | number | CSS pixels on the 500px-tall card. |
| height* | number | CSS pixels on the 500px-tall card. |
| opacity | number |
| rotationX | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationY | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationZ | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| borderRadius | number |
| screenshotId* | string |
| backgroundColor | string |
{
"type": "object",
"required": [
"screenshotId",
"width",
"height"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"html": {
"type": "string",
"description": "Custom card HTML, up to 8000 characters. Image src and CSS url() must be URLs from upload_image with type asset; data: URLs are rejected. font-family can use built-in editor fonts and fonts added with add_project_font; @import and external stylesheets are rejected. Mark everything a user may want to change, so the editor's Content panel can edit it and AI translation translates it: data-edit=\"text\" on each element whose words change (headlines, labels, list rows, numbers; put it on the innermost element holding the words; line breaks are <br>), data-edit=\"image\" on an <img> or on an element with a CSS background-image, data-edit-color=\"--accent\" on an element whose style sets that CSS variable (use it as var(--accent); comma-separate several), data-edit-list on a container whose direct children are repeatable items (rows, bullets, cards), with data-max (default 12) and data-min (default 1). data-label names a field or list in the panel. Text in unmarked elements is not translated."
},
"layer": {
"enum": [
"front",
"back"
],
"type": "string",
"description": "front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes."
},
"scale": {
"type": "number",
"description": "Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"opacity": {
"type": "number"
},
"rotationX": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationY": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationZ": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"backgroundColor": {
"type": "string"
}
},
"additionalProperties": false
}| imageScale | number |
| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId* | string |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"imageScale": {
"type": "number"
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}| string |
| borderRadius | number |
| screenshotId* | string |
| textShadowBlur | number |
| backgroundColor | string |
| textShadowColor | string |
| textShadowEnabled | boolean |
| textShadowOffsetX | number |
| textShadowOffsetY | number |
{
"type": "object",
"required": [
"screenshotId",
"content"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"align": {
"enum": [
"left",
"center",
"right"
],
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"content": {
"type": "string"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"rotation": {
"type": "number"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"fontWeight": {
"type": "string"
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"textShadowColor": {
"type": "string"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"additionalProperties": false
}| number |
| 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationY | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationZ | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| borderRadius | number |
| screenshotId* | string |
| backgroundColor | string |
{
"type": "object",
"required": [
"screenshotId",
"divId"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"html": {
"type": "string",
"description": "New card HTML, with the same rules as add_div html. Empty string clears the card."
},
"divId": {
"type": "string"
},
"layer": {
"enum": [
"front",
"back"
],
"type": "string",
"description": "front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes."
},
"scale": {
"type": "number",
"description": "Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"opacity": {
"type": "number"
},
"rotationX": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationY": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationZ": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"backgroundColor": {
"type": "string"
}
},
"additionalProperties": false
}| imageScale | number |
| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId* | string |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"type": "object",
"required": [
"screenshotId",
"phoneId"
],
"properties": {
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"phoneId": {
"type": "string"
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"imageScale": {
"type": "number"
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}| imageScale | number |
| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId* | string |
| imageDisabled | boolean |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| backgroundColor | string |
| backgroundImage | string |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| hideCardOverflow | boolean |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string |
| backgroundImageBlur | number |
| backgroundPatternId | string |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| backgroundPatternColor | string |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"imageScale": {
"type": "number"
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageDisabled": {
"type": "boolean"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"backgroundImage": {
"type": "string"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"hideCardOverflow": {
"type": "boolean"
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"backgroundImageBlur": {
"enum": [
0,
1,
2,
3
],
"type": "number"
},
"backgroundPatternId": {
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"backgroundPatternColor": {
"type": "string"
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}| number |
| Multiplier of the font size |
| borderColor | string |
| borderRadius | number |
| screenshotId* | string |
| textShadowBlur | number |
| backgroundColor | string |
| textShadowColor | string |
| textShadowEnabled | boolean |
| textShadowOffsetX | number |
| textShadowOffsetY | number |
{
"type": "object",
"required": [
"screenshotId",
"textId"
],
"properties": {
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"align": {
"enum": [
"left",
"center",
"right"
],
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"textId": {
"type": "string"
},
"content": {
"type": "string"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"rotation": {
"type": "number"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"fontWeight": {
"type": "string"
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"textShadowColor": {
"type": "string"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"additionalProperties": false
}