Beta Coming soon. This feature is still being built, so names and details may change before it ships.

App Preview

See your running app inside Ingot at any device size, switch between local ports, and pick an element on the page to send it to the agent.

The App Preview tab shows the app your dev server is running, next to your code. Switch between the servers on your machine, try it as a phone, tablet or desktop, then click any element and ask the agent to change it. The agent gets the element's selector, its source file and its styles.

The Ingot App Preview tab: a shop app on an iPhone 15 Pro frame showing its mobile layout, with the address bar, port chip, device chip and Pick elementThe Ingot App Preview tab: a shop app on an iPhone 15 Pro frame showing its mobile layout, with the address bar, port chip, device chip and Pick element
The Ingot App Preview tab: a shop app on an iPhone 15 Pro frame showing its mobile layout, with the address bar, port chip, device chip and Pick element

Open the App Preview

HowWhere
Open App PreviewFind Action, or ⌘⌥⇧9 (Ctrl+Alt+Shift+9 on Windows and Linux)
Open in App PreviewThe phone button on a port in the Ports tool window
A dev server in the empty tabThe App Preview lists the dev servers it finds; click one to open it

The tab remembers its address, device and zoom between sessions.

The address bar and ports

Type a full URL, a host and path (localhost:3000/cart) or just a port (5173) and press Enter. Back, Forward and Reload work like a browser.

The port chip shows the port you are on. Click it for the dev servers and web pages running on your machine:

GroupWhat is in it
Dev serversPorts served by a dev framework (Vite, Next.js, Nuxt, SvelteKit, Astro, Remix, Storybook, Gatsby, Expo, Angular, Webpack) or an app runtime (node, bun, deno, python, ruby, php, …), with the page title
Other web pagesOther local ports that serve an HTML page, such as an app published from a Docker container, with the process that owns it

Switching ports keeps the page you are on: localhost:5173/cart?step=2 becomes localhost:5174/cart?step=2. Type a port in the menu to open one that is not listed. The list refreshes while the menu is open. Switch Preview Port… in Find Action does the same from the keyboard.

The App Preview port menu: dev servers with their framework badge and page title, the current port checked, then other web pagesThe App Preview port menu: dev servers with their framework badge and page title, the current port checked, then other web pages
The App Preview port menu: dev servers with their framework badge and page title, the current port checked, then other web pages

Which ports are listed

The port menu and the empty tab only offer ports that can be your app. A port is listed when it answers HTTP and either:

  • the process that owns it is a dev server or app runtime: node, bun, deno, vite, next, webpack, python, uvicorn, ruby, rails, php, java, go, and similar, or
  • it serves an HTML page (status below 400).

These are never listed:

Left outExamples
Ingot's own portsIngot's server (INGOT_PORT, 3100 in the web build), the automations receiver (7391 by default), and any port held by the Ingot window itself
Other Ingot windowsAnother Ingot, for example the web build running on :3100, and the local helpers of every other Ingot window (each answers with an x-ingot-service header, so it is never mistaken for a dev server)
OS services and desktop appsAirPlay (ControlCenter), rapportd, app helpers such as Discord Helper or Slack Helper, IDE language servers, Spotify, Postman
HTTP services that are not pagesA local JSON API owned by a process that is not a dev server, or an error page
Databases and system portsPorts below 1024, Postgres, MySQL, Redis, MongoDB and the Node inspector

You can still open any port: type it in the menu or in the address bar.

The port menu and the device menu always stay inside the App Preview panel, even when the panel is narrower than the menu: the menu takes at most the panel's width and starts at its left edge.

The port menu in a 388 px App Preview panel next to the chat: both edges inside the panel, Local servers with two dev servers, :40689 Vite Forge Shop and :33995 Forge Admin, and nothing of Ingot'sThe port menu in a 388 px App Preview panel next to the chat: both edges inside the panel, Local servers with two dev servers, :40689 Vite Forge Shop and :33995 Forge Admin, and nothing of Ingot's
The port menu in a 388 px App Preview panel next to the chat: both edges inside the panel, Local servers with two dev servers, :40689 Vite Forge Shop and :33995 Forge Admin, and nothing of Ingot's
The App Preview port menu listing only dev servers and web pages: a Vite shop, a Docker app and node servers, with Ingot's own port and system services left outThe App Preview port menu listing only dev servers and web pages: a Vite shop, a Docker app and node servers, with Ingot's own port and system services left out
The App Preview port menu listing only dev servers and web pages: a Vite shop, a Docker app and node servers, with Ingot's own port and system services left out

Device sizes

The device chip picks the viewport the page is laid out for. The page's own CSS media queries see that width, so you get its real mobile layout.

CategoryDevices
ResponsiveFills the panel; the chip shows the live size
PhonesiPhone SE (375×667), iPhone 15 Pro (393×852), iPhone 15 Pro Max (430×932), Pixel 8 (412×915), Galaxy S23 (360×780)
TabletsiPad mini (768×1024), iPad Pro 11" (834×1194)
DesktopsLaptop (1280×800), Desktop (1440×900), Full HD (1920×1080)
CustomYour own width and height, from 200 to 3840 px
  • Rotate swaps width and height for landscape. Choosing another device starts in portrait again.
  • Zoom is Fit by default: a device bigger than the panel is scaled down to fit and the menu shows the scale, for example Fit (64%). Pick 50%, 75%, 100% or 125% for a fixed size.
  • In the desktop app, phones and tablets also send their mobile user agent, so apps that serve different pages to phones show their mobile pages.

Choose Preview Device…, Rotate Preview Device and Reload App Preview are in Find Action.

Beta To open the page on iOS Simulators, Android emulators and real phones, with device frames and a QR code, turn on Mobile preview.

Pick an element for the agent

Click Pick element (⌘⇧C, Ctrl+Shift+C while the App Preview has focus). Hover the page: the element under the pointer gets an outline with its tag, classes and size. Click to pick it. The page never gets that click, so links are not followed and buttons do nothing. Press Escape or Cancel to stop.

Picking in the App Preview: the Buy now button outlined with a button.buy.primary 138×35 label, and the picking banner with CancelPicking in the App Preview: the Buy now button outlined with a button.buy.primary 138×35 label, and the picking banner with Cancel
Picking in the App Preview: the Buy now button outlined with a button.buy.primary 138×35 label, and the picking banner with Cancel

The picked element shows in a card under the page:

In the cardWhat it is
LabelThe tag with its id and classes, its text and its size, for example <button.buy.primary> "Buy now — 49 €" 138×35
SelectorA unique CSS selector: the id, a data-testid, or tags with stable classes
SourceThe file and line the element comes from, when the app tells: a data-source, data-loc or data-inspector attribute from a source plugin, React's development build, Vue's __file or Svelte's dev metadata

Type what you want and press Enter or Send to agent: your request and the element go to the agent as one message. Add to chat puts an element chip in the chat input instead, so you can write a longer message or pick more elements. Click the chip to open its source file at the line.

The picked-element card: the button's label, selector and source file, a request for the agent, and Add to chat and Send to agentThe picked-element card: the button's label, selector and source file, a request for the agent, and Add to chat and Send to agent
The picked-element card: the button's label, selector and source file, a request for the agent, and Add to chat and Send to agent

What the agent gets

The element goes with your message as a short block:

Page: Forge Shop (http://localhost:5173/)
Device: iPhone 15 Pro · 393×852
Element: <button.buy.primary> "Buy now — 49 €"
Selector: button.buy.primary
Path: body > main > section.card > button.buy.primary
Source: src/components/BuyButton.tsx:8:7 (data attribute)
Box: 138×35 at (37, 169)
Styles: display: inline-block; background-color: rgb(59, 111, 217); border-radius: 8px; …
Attributes: type="button" class="buy primary"
HTML: <button class="buy primary" type="button">Buy now — 49 €</button>

Only styles that differ from the browser defaults are sent. The HTML, text and attributes are cut to a few hundred characters, so a large element does not fill the prompt. The source path is relative to your project.

Desktop and web

Desktop appWeb build
The pageYour app runs live, scripts and all, in its own session (cookies apart from Ingot and the agent's browser)Ingot's backend loads the page without running its scripts
Device user agentSentNot sent
Element pickerYesYes

Keyboard shortcuts

ActionmacOSWindows / Linux
Open App Preview⌘⌥⇧9Ctrl+Alt+Shift+9
Pick Element for Agent⌘⇧CCtrl+Shift+C
Cancel Element PickEscEsc
Add Picked Element to Agent Chat⌘⇧LCtrl+L
Switch Preview Port…⌘⌥PCtrl+Alt+P
Choose Preview Device…⌘⌥GCtrl+Alt+G
Rotate Preview Device⌘⌥JCtrl+Alt+J
Reload App Preview⌘⌥UCtrl+Alt+U

Every shortcut except Open App Preview works while the App Preview has focus. All of them are in Find Action and in the keymap settings.

Privacy

The port list only probes ports on your machine, over loopback. Nothing about your app leaves the machine until you send a picked element to the agent, and then only the block above goes with your message.

From the terminal

ingot preview lists the same servers and device sizes, and checks a port from scripts:

ingot preview servers                       # dev servers first, then other web pages; --dev, --json
ingot preview devices                       # sizes and the ids --device takes
ingot preview check 5173 --wait 30          # waits for a dev server to answer; exits 1 if it does not
ingot preview check localhost:3000/cart --device iphone-15-pro --json
CommandWhat it does
serversThe same ports as the port menu (see Which ports are listed), ranked the same way, with the framework, page title and process. --dev keeps dev servers only; --exclude <port> leaves ports out
devicesThe device sizes and their ids
check <port|url>Status, page title and dev framework. Exits 1 when nothing answers or the page is an error. --wait <seconds> keeps trying; --device <id> adds the viewport and user agent

Every command takes --json. No model is called and no account is needed.