Start your Storybook dev server with npm run storybook, which serves on http://localhost:6006 by default, then run “Mobile Preview: Show” from the VS Code Command Palette. The extension detects the server, shows your app in a phone or tablet frame next to your code and reloads it each time you save.
Set up
Storybook serves on port 6006 by default. Previewing it in a device frame lets you review each component story at phone size.
- Install the extension and start your server with npm run storybook.
- Open the Command Palette and run “Mobile Preview: Show”.
- Check that the address bar shows http://localhost:6006; if your terminal printed another port, type that address instead.
- Choose a device from the menu and edit your code.
What to check on a phone with Storybook
- Each component story at phone width, in portrait and landscape.
- Text that wraps or overflows inside buttons, cards and badges.
- Touch target sizes of interactive components.
Common checks for any framework
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.
Frequently asked questions
- What port does Storybook use in development?
- Storybook serves on port 6006 by default (http://localhost:6006). If that port is busy, the dev server usually moves to another one and prints it in the terminal.
- Does Mobile Preview work with Storybook?
- 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.
Install Mobile Preview from the Visual Studio Marketplace · Open VSX (Cursor, Windsurf, VSCodium) · Pricing
More: all guides · device sizes · How to preview a Next.js app on mobile inside VS Code · How to preview a Vite (React, Vue, Svelte) app on mobile inside VS Code · How to preview a Nuxt app on mobile inside VS Code · How to preview a Astro app on mobile inside VS Code · How to preview a SvelteKit app on mobile inside VS Code