A collection of TIC-80 games, automatically built and deployed as a playable web gallery via GitHub Pages.

games/
  lunar-lander/      # Each game gets its own directory
    game.lua         # TIC-80 Lua source
    meta.json        # Title, description, author, controls
build/
  build.py           # Compiles games into HTML gallery
docs/                # Generated output (deployed to GitHub Pages)

1. Create a folder under games/ with your game slug (e.g. games/my-game/)
2. Add a game.lua with your TIC-80 Lua source code
3. Add a meta.json:

   {
     "title": "My Game",
     "author": "Your Name",
     "description": "A short description of the game.",
     "controls": "Arrow keys to move, Z to shoot",
     "thumbnail_color": "#1a1a2e"
   }

4. Commit and push to main — the gallery rebuilds automatically.

python3 build/build.py
# Open docs/index.html in a browser

The GitHub Actions workflow (.github/workflows/deploy.yml) automatically:

• Detects changes to games/ or build/
• Runs the build script
• Deploys the docs/ output to GitHub Pages