PixelBullet Documentation

Table of Contents

• What Lives Here
• Documentation Map
  • Guides
  • Module Notes
  • API Surface
• Build And Verification Entry Points
• Packaging Notes
• Theme Integration

This site is the generated documentation home for the PixelBullet workspace. It complements the repository root README.md, which remains the main onboarding document for host setup, build/test quickstarts, and day-to-day development workflows.

What Lives Here

• Hand-authored documentation pages under docs/
• Generated API and source documentation for engine/src/PixelBullet
• Durable module-local notes that are useful to keep alongside the code they describe

Documentation Map

Guides

• Logging workflow

Module Notes

• The graphics and shader pipeline notes live in the Graphics Module page generated from engine/src/PixelBullet/Graphics/README.md.

API Surface

• Public engine headers are exported through the engine Bazel package and documented from engine/src/PixelBullet.
• The editor and sandbox stay application-focused; their source trees are not treated as primary API documentation surfaces.

Build And Verification Entry Points

The repository is Bazel-first. The main entrypoints are:

bazel test //:repo_tests
bazel build --config=debug //editor:pixelbullet-editor
bazel build --config=debug //examples/sandbox:sandbox-app
bazel run //tools/dev:refresh_compile_commands
bazel build //doxygen:html

The generated HTML output is written under bazel-bin/doxygen/html/.

Packaging Notes

PixelBullet currently ships two Bazel packaging targets:

• //packaging:bundle_sdk for a host-specific SDK archive
• //packaging:bundle_release for a host-specific runtime bundle used for local and CI workflows

The SDK bundle is the coherent packaged output of the current repo pass. The runtime bundle should still be treated as a host-specific developer artifact rather than a portable distribution.

Theme Integration

This site uses a vendored copy of Doxygen Awesome from static/doxygen-theme/. The theme is intentionally kept local for now so the documentation build remains straightforward and reproducible inside the workspace.