Skip to Content
DocsEnFeaturesLive Preview

Live Preview

See your changes in real-time as AI writes code. The preview panel automatically refreshes when files are modified.

Features

Auto-Refresh

Preview automatically detects file changes and refreshes the iframe. No manual refresh needed!

Toggle auto-refresh with the โšก button in the preview header.

Device Simulation

Test your app on different screen sizes:

DeviceSizeUse Case
Desktop100%Full desktop view
Tablet768ร—1024iPad and tablets
Mobile375ร—667iPhone and phones

Console Viewer

Switch to the Console tab to view:

  • Server logs (stdout/stderr)
  • Browser console output
  • Build errors
  • Runtime errors

Error Overlay

Build errors are displayed directly on the preview with:

  • File location
  • Error message
  • Stack trace
  • Line numbers

Controls

ButtonAction
โ–ถ PlayStart preview server
โฌ› StopStop preview server
๐Ÿ”„ RestartRestart preview server
โ†ป RefreshManually refresh iframe
โ›ถ OpenOpen in new tab

Project Ready Status

Before preview starts, ClaudeShip checks if your project is ready:

Frontend Only

  • package.json exists
  • dev script defined

Full Stack (Express)

  • Frontend requirements met
  • Backend package.json exists
  • Backend dev script defined

Full Stack (FastAPI)

  • Frontend requirements met
  • requirements.txt exists
  • main.py exists

If any requirement is missing, youโ€™ll see a checklist in the preview panel.

Auto-Start

Preview automatically starts when your project becomes ready. No need to manually click the start button!

Last updated on