GEngine

GEngine is an InkJS-based interactive story demo (static HTML/JS) with Playwright smoke tests.

Repository layout (high-level)

• docs/ — project docs, workflow notes, PRDs
• web/ — InkJS demo (/demo) and stories (/stories)
• tests/ — Playwright smoke tests

Prerequisites

Node.js

• Node.js + npm

InkJS web demo

The demo is a static site under web/ that fetches web/stories/demo.ink at runtime.

Run locally

npm install
npm run serve-demo

Then open:

• http://127.0.0.1:8080/demo/

Notes:

• Serve from repo root or web/ so /stories/demo.ink is reachable.

More details: docs/InkJS_README.md.

GitHub Pages demo

When a commit lands on main, GitHub Pages publishes the static demo from web/demo at:

• https://thewizardscode.github.io/GEngine/demo/

Notes:

• Assets (stories) are fetched relative to the repo path, so the demo works from both local http://127.0.0.1:8080/demo/ and Pages.

Tests (web demo)

Playwright tests run against the hosted demo.

npm test

If Playwright browsers are not installed yet:

npx playwright install

Key docs

• docs/InkJS_README.md
• docs/prd/GDD_M1_dynamic_interactive_story_engine.md
• docs/dev/Workflow.md