Guide

Core Concepts

The runtime pieces behind Groundpack and command-backed previews.

Architecture overview

Groundpack workspaces combine a virtual filesystem, package installation, command execution, and a browser HTTP bridge.

  • VirtualFS stores all project files in memory.
  • Runtime executes modules against that filesystem.
  • PackageManager installs real npm packages into /node_modules.
  • The server bridge connects virtual servers to browser URLs through a service worker.

Public facade

The root package should expose WebContainer-compatible APIs from Groundpack as they are implemented.

Until a compatibility API is implemented, it is intentionally absent from the root export surface.

Command-backed servers

Templates start dev servers by running the same package scripts a local project would run.

Groundpack forwards server-ready events to the host UI so previews can load the virtual URL.