BLIT386BLIT386

Documentation

Public API reference and guides for the BLIT386 palette-first WebGPU engine.

This is the public documentation for the BLIT386 engine. New here? Start with Getting Started. For the API, see API: Core for bootstrap(), initialization, and the configure surface. The pages below mirror the canonical engine documentation maintained in the blit386 repository.

API reference

PageWhat it covers
API: Corebootstrap, initialization, and default configuration
API: Overlayoverlay HUD configure flags, style objects, worked examples
API: Game Loopfixed-timestep timing, tick counters, and Timer
API: Camerathe camera's global pixel offset and world-clamp helpers
API: Easingnamed easing curves via applyEasing
API: Core Typesthe integer core types: Vector2i, Rect2i, Color32
Browser SupportWebGPU support matrix, software fallback, build toolchain
API: Renderingprimitives, sprites, text, post-process, frame capture
API: Palettepalette setup, presets, effects, serialization
API: Assetssprite sheets, bitmap fonts, and asset loading
API: Audiobus volume and mute, playback, and the autoplay-unlock state

Guides

PageWhat it covers
Input Guidepointer, keyboard, gamepad, text accumulation
Game Loop Guidesmoothing motion between fixed update() steps
Palette Guidethe palette-first workflow, offsets, and effects
Palette Presetsbuilt-in preset palettes and the HUD preset
Overlay Guideengine HUD subsystem, toggle, layout
Post-Process Effectsthe effect chain, built-in effects, CRT presets
Bitmap Fontsthe system font and custom .btfont fonts
Audio Guidebus layout, the gesture unlock rule, web audio

Performance

PageWhat it covers
Best Practicesallocation, batching, and hot-path guidance
Performance TestingCPU micro-benchmarks and the CI gate
Software Fallback Smoke Matrixbackend smoke-test coverage

Reference

PageWhat it covers
Deprecation Timelinerenamed configure flags, getters, and aliases
Changelogrelease history: what shipped, what broke, when
Testingtest tiers, WebGPU mocks, and visual regression
Authorswho made this

Contributor-only documentation - the developer experience guide, the documentation and versioning guide, the voice guide, tooling notes, and the security runbook and policies - is not mirrored here and stays in the engine repository on GitHub.

On this page