WebContainer Lifecycle Adapter

Overview

This skill creates or reviews one application-owned boundary around WebContainer startup and capabilities. The adapter makes boot idempotent, exposes explicit runtime states, tracks event unsubscriptions and processes, and prevents UI components from independently manipulating a shared instance.

Prerequisites

• A named repository and the components that currently own runtime behavior
• The installed @webcontainer/api type definitions as the local API authority
• Expected mount, process, preview, export, and disposal use cases

Tool Discipline

Use Read, Glob, and Grep to map imports, boot calls, process ownership, filesystem mutations, event subscriptions, and teardown paths. Use WebFetch only for current official StackBlitz or WebContainers documentation. Use Write or Edit after proposing the adapter boundary and compatibility impact.

Current Contract