---
title: vgpu Docs
description: Build WebGPU applications for browsers and Node.js, and explore WGSL integration with native Metal code.
---

# vgpu Docs



vgpu is a TypeScript library for building WebGPU applications with one composable API. Write modular WGSL once, then use the same shaders for interactive canvases, headless rendering, images, video, and automated tests. The Native section documents the in-development WGSL-to-Metal workflow; its complete installed toolchain is not published yet.

## How to use these docs

* [Get started](/docs/get-started) — install vgpu and render your first frame.
* [Learn the concepts](/docs/concepts) — understand GPUs, targets, frames, effects, and adapters.
* [Integrate WGSL with native Metal](/docs/native) — generate a self-contained Swift shader package for application-owned Metal code.
* [Explore the examples](/examples) — see live WebGPU demos and inspect their source.
* [Explore the guides](/docs/guides) — solve specific problems involving integrations, performance, testing, and shader authoring.
* [Browse the API reference](/docs/reference) — look up packages, types, and functions.

Using a coding agent? Run `npx vgpu` to give it access to the docs, verified examples, validation tools, and runtime diagnostics.

## Tools and workflows

* [CLI](/docs/cli) — explore documentation, inspect examples, validate WGSL, and diagnose the runtime.
* [MCP](/docs/mcp) — connect agents to VGPU documentation and verified examples.
* [ML](/docs/ml) — run ONNX models alongside vgpu on a shared `GPUDevice`.


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)