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:
| Device | Size | Use Case |
|---|---|---|
| Desktop | 100% | Full desktop view |
| Tablet | 768ร1024 | iPad and tablets |
| Mobile | 375ร667 | iPhone 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
| Button | Action |
|---|---|
| โถ Play | Start preview server |
| โฌ Stop | Stop preview server |
| ๐ Restart | Restart preview server |
| โป Refresh | Manually refresh iframe |
| โถ Open | Open in new tab |
Project Ready Status
Before preview starts, ClaudeShip checks if your project is ready:
Frontend Only
package.jsonexistsdevscript defined
Full Stack (Express)
- Frontend requirements met
- Backend
package.jsonexists - Backend
devscript defined
Full Stack (FastAPI)
- Frontend requirements met
requirements.txtexistsmain.pyexists
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