---
title: WebGPU OS
description: Section index for the WebGPU OS — GPU-first compositor, shell, kernel, and package system (overview, architecture, getting started, app catalog, API reference).
updated: 2026-06-12
---

# WebGPU OS

GPU-first compositor, shell, kernel, and package system that boots in a browser tab. Source: `webgpu-os/`.

## In this section

- [Overview](overview.md) — what it is, tier framing, subsystems.
- [Architecture](architecture.md) — kernel, shell, packages, storage, drivers, app contract.
- [Realm Network](realm-network.md) — portable identity, content, resumable links, semantic replication, governance, discovery, V3 compatibility, and one-shot deployment policy.
- [Navi Architecture and Delivery](navi-architecture-and-delivery.md) — persistent identity, cognition, Faculties, causal memory, bounded autonomy, Manifestations, and recovery gates.
- [AI Echo Live Patch](ai-echo-live-patch.md) — clean-room declarative, reversible live editing for OS apps, shell surfaces, AI Echo, and extension-backed browser tabs.
- [AI Echo Artifact Studio](ai-echo-artifact-studio.md) — file-backed, versioned work products with native, declarative, and opaque-sandbox previews beside the conversation.
- [AI Echo Clicks and Clankers](ai-echo-clicks-and-clankers.md) — clean-room WebMCP discovery, verified semantic browser control, exact approvals, receipts, and React state synchronization.
- [AppForge Contracts](appforge-contracts.md) — modular part registry, deterministic assembly, context graph, layout zones, package exports, timeline, lenses, starter packs, and builder contracts.
- [Getting Started](getting-started.md) — boot the OS and build an app.
- [App Catalog](app-catalog.md) — all 35 built-in apps.
- **API Reference** — per-file symbols from `kernel/`, `shell/`, `packages/`, `storage/`, `drivers/`, `browser-bridge/`, `browser-extension/` (browse `webgpu-os/reference/`).

## Module map

```text
webgpu-os/
  index.js / boot.js   bootWebGpuOS entry
  kernel/    KernelBootstrap, Syscalls, AppRegistry, ModRegistry, Permissions,
             TrustStore, GpuDeviceBroker, VRAMTracker, ThemeEngine, VirtualFS, ...
  shell/     Desktop, Taskbar, StartMenu, StatusTray, DialogManager, NotificationCenter
  packages/  PackageManager, PackageLoader, PackageBuilder, PackageVerifier, UpdateManager, ...
  storage/   VirtualFS, SystemFS, OPFSDriver, IndexedDBDriver, MountDriver, AppSandbox
  appforge/  Definitions, registry, tags, scoring, services, context, commands,
             layout, blueprints, packages, timeline, lenses, packs, builder
  drivers/   AudioDriver, CryptoDriver, NetDriver, ProfileDriver, WebSurfaceDriver
  browser-bridge/ browser-extension/   native browser integration + adblock
  apps/      35 runtime-discovered apps (apps/index.json)
```

## Related concepts

- [Boot Sequence](../concepts/boot-sequence.md)
- [GPU Device Sharing](../concepts/gpu-device-sharing.md)
- [Security & Trust Model](../concepts/security-model.md)
- [Data Flow](../concepts/data-flow.md)