# Motion GPU

> Motion GPU is A WebGPU-first library for Svelte 5. 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

- [MotionGPU Documentation](https://motion-gpu.dev/docs/raw/): Framework-agnostic WebGPU core with a Svelte 5 adapter for fullscreen WGSL rendering.
- [Getting Started](https://motion-gpu.dev/docs/raw/getting-started): Step-by-step guide to installing MotionGPU 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 MotionGPU.
## 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 and controlling rendering with useMotionGPU and context hooks.
- [User Context](https://motion-gpu.dev/docs/raw/user-context): Advanced read/write API for namespaced, reactive shared state within the MotionGPU 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.
## Shaders & Textures

- [Writing Shaders](https://motion-gpu.dev/docs/raw/writing-shaders): WGSL concepts, conventions, and patterns for effective shader authoring in MotionGPU.
- [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.
## 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, useTexture, and user context APIs.
- [Passes API](https://motion-gpu.dev/docs/raw/api-passes-reference): Reference for ShaderPass, BlitPass, CopyPass, and render pass slot contracts.
- [Core Runtime 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.

## 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.