---
title: Guides
description: Task-oriented guides for using vgpu effectively.
---

# Guides



Task-oriented notes for performance, browser testing, measurement, and shader authoring.

## General

<Cards>
  <Card title="Getting started" href="/docs/guides/getting-started" />
</Cards>

## Performance

<Cards>
  <Card title="Performance model" href="/docs/guides/performance-model" />

  <Card title="Performance patterns" href="/docs/guides/performance-patterns" />

  <Card title="Authoring shaders for performance" href="/docs/guides/authoring-for-perf" />

  <Card title="Measuring" href="/docs/guides/measuring" />

  <Card title="Optimize a pass" href="/docs/guides/optimize-pass" />

  <Card title="Shader diagnostics and fix-its" href="/docs/guides/shader-fix-its" />

  <Card title="Performance playbook: write fast vgpu by default" href="/docs/guides/performance-playbook" />
</Cards>

## Testing

<Cards>
  <Card title="Browser testing with Playwright WebGPU" href="/docs/guides/browser-testing" />
</Cards>

## More guides

<Cards>
  <Card title="WebGPU screenshots with agent-browser" href="/docs/guides/agent-browser-webgpu" />

  <Card title="External ticker" href="/docs/guides/external-ticker" />

  <Card title="Using vgpu with Next.js and other bundlers" href="/docs/guides/nextjs" />

  <Card title="Using vgpu without a bundler" href="/docs/guides/no-bundler" />

  <Card title="Publishing WGSL module packages" href="/docs/guides/publishing-wgsl-packages" />

  <Card title="Debugging shaders by extracting internal values" href="/docs/guides/shader-debugging" />

  <Card title="The default workflow for developing shaders with vgpu" href="/docs/guides/shader-workflow" />

  <Card title="Practical texture-format matrix" href="/docs/guides/texture-formats" />

  <Card title="Two-pass rendering: offscreen depth target composited to the canvas" href="/docs/guides/two-pass-rendering" />
</Cards>


---

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)