BLIT386BLIT386
Documentation

Build a Game

Start here to build a BLIT386 game from an empty folder: the starter template, AGENTS.md, kit guides, skills, and examples.

Written for blit386 1.8.0. The rest of blit386.dev documents the newest engine, so an API you find there may be missing from a game pinned to 1.8.0.

Everything needed to write a BLIT386 game from scratch, with no project on disk yet. Every page here can be read through the blit386-docs MCP server: find it with search_docs, read it with get_doc_page.

Quickest start

npm create blit386@latest my-game creates the whole project, with these same guides, skills, and rules already on disk.

Without the scaffolder

  1. Write the four files on the Starter Template page into an empty folder.
  2. Run npm install, then npm run dev.
  3. Read AGENTS.md - the rules every BLIT386 game follows.
  4. Replace the starter game in src/game.js with your own, using the skills below for each feature.

Kit guides

In a scaffolded game these are the files in docs/.

Skills

One task each. In a scaffolded game they live in .claude/skills/.

Rules

Examples

Programs from the demo site, each running live at demos.blit386.dev. Most call demo-site helpers from ./shared/ and are not standalone; each page says what it needs. The full set of demos is at https://demos.blit386.dev.

Getting Started

Create a new BLIT386 game with the scaffolder, or add the engine to an existing project.

Starter Template

The four files of a new BLIT386 game - package.json, index.html, vite.config.js, src/game.js.

On this page

Quickest startWithout the scaffolderKit guidesSkillsRulesExamples