Docs
The documentation is the skill
ignifx does not keep a separate manual. The Agent Skill that ships with the engine is the documentation, and this site renders it — the same files, at stable URLs, indexed for agents at /llms.txt. Everything below that is not a skill page is a design document in the repository.
62 pages
The skill, rendered here
Start at the entry skill; each extension adds one. Every URL below is exactly what llms.txt lists, and the build fails if one of them does not resolve.
2 pages
Entry skill
9 pages
Extensions
7 pages
Concepts
16 pages
Recipes
15 pages
File formats
13 pages
API reference
docs/architecture
Architecture
One document per area, written before the code and corrected by it.
00-overview.md00 · Architecture Overview01-lifecycle-and-time.md01 · Lifecycle and Time02-scene-graph.md02 · Scene Graph: World, Scenes, Entities, Transforms03-scripting-and-components.md03 · Scripting and Components04-extensions.md04 · Extensions05-assets-and-loading.md05 · Assets and Loading06-serialization-and-scene-format.md06 · Serialization and Scene Format07-rendering.md07 · Rendering (the Babylon Lite adapter)08-input.md08 · Input09-physics.md09 · Physics (3D, Havok through Babylon Lite)10-audio.md10 · Audio11-2d-toolkit.md11 · 2D Toolkit12-3d-toolkit.md12 · 3D Toolkit13-ui.md13 · UI14-platform-electron.md14 · Platform: Browser, Electron, Headless15-devtools-and-diagnostics.md15 · Devtools and Diagnostics16-docs-harness-and-skill.md16 · Documentation Harness and the Agent Skill
docs/adr
Decision records
Why the engine is shaped the way it is, including the choices that turned out to be wrong.
0000-template.mdADR-NNNN · Title0001-babylon-lite-webgpu-only.mdADR-0001 · Babylon Lite as the renderer; WebGPU only0002-adapter-boundary.mdADR-0002 · Adapter boundary around Babylon Lite0003-ignifx-owns-the-loop.mdADR-0003 · ignifx owns the frame loop: fixed timestep, simulation scene, engine-driven animation0004-schema-serialization-no-decorators.mdADR-0004 · Schema-driven serialization through `Component.define`; no decorators0005-scenes-are-prefabs.mdADR-0005 · One file format: scenes are prefabs0006-2d-physics-backend.mdADR-0006 · 2D physics backend0007-typescript-7-with-ts6-shim.mdADR-0007 · TypeScript 7 as the compiler, TypeScript 6 aliased for API-dependent tools0008-dom-ui-layer.mdADR-0008 · Game UI is HTML over the canvas; world text uses Lite text0009-monorepo-tooling.mdADR-0009 · Monorepo tooling0010-coroutines-are-generators.mdADR-0010 · Frame-sequenced logic uses generator coroutines, not async/await0011-coordinate-system-and-units.mdADR-0011 · Left-handed, Y-up, +Z forward; metres, seconds, degrees0012-entity-component-script-vocabulary.mdADR-0012 · Vocabulary: App, World, Scene, Entity, Component, Script, System, Extension0013-collision-identity-drain-waiver.mdADR-0013 · Waiver: adapter-internal Havok collision-event drain0014-material-warm-up.mdADR-0014 · Material families are warmed up before the scene is registered0017-navigation-wasm.mdADR-0017 · How the Recast navigation WebAssembly is loaded0018-electron-tooling.mdADR-0018 · Electron, electron-vite, and electron-builder0019-website-static-site.mdADR-0019 · The public website: a prerendered static site on Cloudflare Pages
CONSTITUTION.md
Rules and process
CONSTITUTION.mdNumbered clauses: principles, architecture tenets, versioning, security, licensing.docs/standards/coding-standards.mdToolchain, TypeScript configuration, lint, naming, testing, CI.docs/plan/engineering-plan.mdThe phased plan from an empty repository to 1.0, with each phase's recorded status.AGENTS.mdThe entry point for contributors and for coding agents.CONTRIBUTING.mdCommands, commit conventions, and what a pull request has to carry.