video-shader-toys/runtime/README.md

Runtime Files

This directory is used by the native host for local runtime output.

Tracked files:

• templates/: source templates used to generate shader runtime code.

Packaged documentation:

• ../docs/openapi.yaml: OpenAPI/Swagger spec for the local control API.
• http://127.0.0.1:<serverPort>/docs: Swagger UI page served by the native control server.

Generated files:

• shader_cache/active_shader_wrapper.slang: generated Slang wrapper for the active shader/layer.
• shader_cache/active_shader.raw.frag: raw GLSL emitted by slangc.
• shader_cache/active_shader.frag: patched GLSL consumed by the OpenGL path.
• runtime_state.json: persisted layer stack and parameter values.
• stack_presets/*.json: user-saved layer stack presets.

Git policy:

• Runtime cache/state/preset output is ignored by default.
• Template files are source files and should stay tracked.
• If a project wants shared stack presets, move selected preset JSON files into a tracked fixtures or presets directory intentionally rather than committing the whole runtime output tree.