Skip to content

Complete live preview / webview feature with HMR #87

@kivo360

Description

@kivo360

Problem

The live preview feature — viewing the project in a webview with hot module replacement (HMR) — is a work-in-progress. Backend infrastructure exists but isn't fully connected:

  • backend/omoi_os/services/preview_manager.py — PreviewManager service exists
  • backend/omoi_os/models/preview_session.py — PreviewSession model exists
  • Frontend webview component status unknown

What needs to happen

  1. Backend: Wire PreviewManager into the API server lifecycle
  2. Frontend: Create/complete the webview component that embeds the live preview iframe
  3. HMR integration: Connect sandbox file changes to HMR updates in the preview
  4. WebSocket: Stream file change events to trigger preview refreshes

Context

This feature lets users see their project running live while agents make changes — the key differentiation for OmoiOS's "watch agents work" value prop.

Difficulty: Hard | Skill: Full-stack (FastAPI + Next.js + WebSocket)

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions