8th-level

Static web-based maze/adventure: 8 levels, each with 8 rooms. The player navigates using answers from a Magic 8-Ball.

How it works

• Open index.html in a browser (or host on GitHub Pages).
• Click Ask the Magic 8-Ball to receive a suggested direction. The game will attempt to move the stickman accordingly.
• Find the room marked Exit to advance to the next level. There are 8 levels total.

Publishing to GitHub Pages (recommended)

Recommended repository name in the organization: literatecomputing/8th-level.

1. Create a new repository on GitHub under the literatecomputing organization named 8th-level.
2. Locally in this project directory, run the following to push the code to the new repo:

git init
git add --all
git commit -m "Initial game files"
git remote add origin git@github.com:literatecomputing/8th-level.git
git branch -M main
git push -u origin main

3. This repo includes a GitHub Actions workflow at .github/workflows/pages.yml which will automatically publish the site to GitHub Pages on pushes to main.

4. After the first successful workflow run, confirm the Pages URL in the repository Settings → Pages (the Actions job will also show the deployment URL).

Notes:

• If you prefer a different Pages configuration (for example docs/ or a dedicated branch), update the repository settings or the workflow accordingly.
• To test locally, run:

python3 -m http.server 8000
# then open http://localhost:8000 in a browser

Files

• index.html — main page
• css/style.css — styles
• js/game.js — game logic
• data/levels.json — level definitions

Feel free to request additional mechanics (inventory, puzzles, randomized exits, or visuals).