Preview a Gatsby app on mobile inside VS Code

Gatsby serves your site on port 8000 with `gatsby develop`.

1. Install the extension and start your server with npm run develop.
2. Open the Command Palette and run “Mobile Preview: Show”.
3. Check that the address bar shows http://localhost:8000; if your terminal printed another port, type that address instead.
4. Choose a device from the menu and edit your code.

• Images from gatsby-plugin-image: check the sizes served to a phone.
• Long article pages: check text width, tables and code blocks.
• Menus that collapse on small screens.

Mobile Preview is a layout preview in a device frame, not an emulator. Check touch behavior and browser-specific rendering on a real phone before you ship.

• The viewport meta tag is present, otherwise phones lay the page out as if it were much wider.
• Tap targets are comfortably large and not too close together.
• Nothing is hidden behind the notch or Dynamic Island: see the viewport sizes and cutouts on the devices page.

What port does Gatsby use in development?

Gatsby serves on port 8000 by default (http://localhost:8000). If that port is busy, the dev server usually moves to another one and prints it in the terminal.

Does Mobile Preview work with Gatsby?

Yes. It works with any page that loads in a browser, and it detects a local dev server automatically. You can also type any URL in its address bar.

Does the preview reload when I save?

Yes. It reloads each time you save a file.

Is it free?

There is a free version with three iPhone models. Pro, a one-time payment of €6.99, adds Android phones, iPads and more iPhones.