Skip to guide
Macaron Docs

Localhost previews

See a running website beside the work that created it.

Start a server

Run your project’s development command in a terminal. When the computer exposes an HTTP port, Macaron can show its preview. Choose the port to open the page, reload it, or open it in your browser.

If the preview is empty

Check the terminal for build errors and verify the server is still running. For a remote or isolated workspace, make sure the server listens on an accessible interface. A localhost-only server may need a relay.

Point and ask · next desktop release

Open the preview, press Point, and click anything on the page. Macaron finds where it is written, such as components/hero.tsx:137, and the components it sits inside. The element appears above the message box and goes to the agent with your next message, so you can say what to change without describing where it is. Press Esc to stop pointing.

  • React (including React 19 with Next.js or Vite), Svelte and Astro: the file and line.
  • Vue: the component file.
  • Anything else: the element itself, with its classes and text, for the agent to find.