# Motion GPU

> Motion GPU is A minimalist WebGPU framework for Svelte 5, React 18/19, and Vue 3. Build high-performance, GPU-accelerated visualizations with a declarative API, strict runtime contracts, and type-safe WGSL shaders.

LLM-friendly Markdown for every page is available at `/docs/raw/<slug>`; this is the source doc content without navigation chrome.
Use `/sitemap.xml` for URL discovery and `/robots.txt` for crawl guidance.

## Getting Started

- [Motion GPU Documentation](https://motion-gpu.dev/docs/raw/): Framework-agnostic WebGPU core with Svelte 5, React 18/19, and Vue 3 adapters for fullscreen WGSL rendering.
- [Getting Started](https://motion-gpu.dev/docs/raw/getting-started): Step-by-step guide to installing Motion GPU and building your first shader.
- [Concepts & Architecture](https://motion-gpu.dev/docs/raw/concepts-and-architecture): Architectural decisions, runtime lifecycle, and the mental model behind Motion GPU.
## Core Concepts

- [Defining Materials](https://motion-gpu.dev/docs/raw/defining-materials): Creating immutable, validated materials with the defineMaterial API.
- [Hooks & Context](https://motion-gpu.dev/docs/raw/hooks-and-context): Accessing runtime state, pointer input, and rendering controls with Motion GPU hooks.
- [User Context](https://motion-gpu.dev/docs/raw/user-context): Advanced read/write API for namespaced, reactive shared state within the Motion GPU runtime.
## Rendering

- [Render Modes](https://motion-gpu.dev/docs/raw/render-modes): Controlling when the canvas re-renders always, on-demand, or manual.
- [Render Passes](https://motion-gpu.dev/docs/raw/render-passes): Building post-processing pipelines with the render graph and built-in pass types.
- [Render Targets](https://motion-gpu.dev/docs/raw/render-targets): Creating off-screen textures for multi-pass rendering and intermediate computation.
- [Frame Scheduler](https://motion-gpu.dev/docs/raw/frame-scheduler): Managing per-frame logic, task ordering, and invalidation with the useFrame API.
## Compute

- [Compute Shaders](https://motion-gpu.dev/docs/raw/compute-shaders): Running GPU compute workloads with ComputePass, PingPongComputePass, and storage buffers.
- [Storage Buffers](https://motion-gpu.dev/docs/raw/storage-buffers): Declaring, writing, and reading GPU storage buffers for compute and fragment shaders.
## Shaders & Textures

- [Writing Shaders](https://motion-gpu.dev/docs/raw/writing-shaders): WGSL concepts, conventions, and patterns for effective shader authoring in Motion GPU.
- [Shader Includes & Defines](https://motion-gpu.dev/docs/raw/shader-includes-and-defines): Using #include directives and compile-time defines for reusable and configurable shader code.
- [Uniforms](https://motion-gpu.dev/docs/raw/uniforms): Passing dynamic values from JavaScript to WGSL shaders declaration, types, and updates.
- [Textures](https://motion-gpu.dev/docs/raw/textures): Declaring textures, configuring samplers, and managing runtime texture updates.
- [Texture Loading](https://motion-gpu.dev/docs/raw/texture-loading): Reactive hook for loading textures from URLs with automatic cleanup and error handling.
## Integrations

- [TypeGPU Integration](https://motion-gpu.dev/docs/raw/integrations-typegpu): Integrating TypeGPU TypeScript shader authoring with Motion GPU runtime rendering and scheduling.
## API Reference

- [FragCanvas Reference](https://motion-gpu.dev/docs/raw/fragcanvas-reference): Complete prop reference and usage guide for the main FragCanvas component.
- [Material API](https://motion-gpu.dev/docs/raw/api-material-reference): Reference for defineMaterial, resolveMaterial, and material contract types.
- [Hooks API](https://motion-gpu.dev/docs/raw/api-hooks-reference): Reference for runtime hooks: useFrame, useMotionGPU, usePointer, useTexture, and user context APIs.
- [Passes API](https://motion-gpu.dev/docs/raw/api-passes-reference): Reference for ShaderPass, BlitPass, CopyPass, ComputePass, PingPongComputePass, and pass slot contracts.
- [Core API](https://motion-gpu.dev/docs/raw/api-core-reference): Framework-agnostic root/core exports for adapter and runtime authors.
- [Advanced API](https://motion-gpu.dev/docs/raw/api-advanced-reference): Scheduler helpers and user-context APIs from advanced entrypoints.
## Advanced

- [Error Handling](https://motion-gpu.dev/docs/raw/error-handling): Understanding the error normalization pipeline, structured reports, and diagnostics.
- [Testing & Internals](https://motion-gpu.dev/docs/raw/testing-and-internals): Test coverage, runtime contracts, and implementation details for library maintainers.
- [Changelog](https://motion-gpu.dev/docs/raw/changelog): All notable changes to Motion Core will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

## Optional

- [GitHub](https://github.com/motion-core/motion-gpu): Source code, issues, and discussions.
- [Package](https://www.npmjs.com/package/@motion-core/motion-gpu): Installation and release metadata.