Gemline Quest

Gemline Quest is a hand-crafted logic puzzle for the browser: drag from jewel to jewel and visit every jewel on the board with one unbroken line. 40 carefully ordered levels, a hint system backed by a fast solver, undo and reset, level select with progress saving, generated SVG artwork and a fully programmatic ambient soundtrack - all in clean, documented ES-module JavaScript on Phaser 3.

Highlights

• 40-level campaign with smoothly increasing difficulty: board size, decoy links and constrained starts scale up level by level
• Drag controls for mouse and touch with a live elastic line segment that follows the pointer
• Undo by dragging back onto the previous jewel or via the Undo button; Reset clears the board instantly
• Hint system reveals a guaranteed-valid next connection (fast DFS solver, instant even on the largest 72-jewel board)
• Level select with locked / available / completed states and automatic linear unlocking
• Animated level-complete celebration and a special campaign-complete screen
• Pause menu with Resume / Restart / Menu; auto-pause when the browser tab loses focus
• Interactive onboarding tutorial on level 1, shown once and remembered
• Separate music and sound-effects toggles on the title screen
• Automatic saving of progress and preferences to localStorage

Technology

• Phaser 3.80 (WebGL and Canvas rendering), vanilla JavaScript ES modules
• Vite 5 dev server and production bundler; a ready-to-upload dist/ production build is included
• Pure-logic puzzle core (models, rules, path controller, hint solver) fully decoupled from the renderer and unit-testable with no Phaser imports
• Runtime-generated SVG artwork: faceted jewels in 7 colors, a full stroke icon set and a gem-pattern background - zero image files shipped
• Programmatic Web Audio: synthesized clicks, chimes, bells plus an ambient drone and pentatonic music sequencer - zero audio files shipped
• Level solvability validator (npm run validate-levels) proves every level's built-in solution is a valid Hamiltonian path

Requirements

• Any modern browser to play; any static host to publish (upload the included dist/ folder - no build tools needed)
• Node.js and npm only if you want to develop or rebuild
• No accounts, no API keys, no network calls - 100% offline and client-side

What You Get

• Complete, well-commented source: structured src/ tree (scenes, puzzle logic, rendering, generated assets, audio synthesis, level data, storage, UI widgets)
• Ready-to-upload dist/ production build playable immediately on any static host
• 40 levels in an easy authoring format (grid size plus a solution walk string) with the solvability validator script
• documentation.html: illustrated setup and customization guide (run, build, deploy, add levels, re-skin, change audio)
• README.md and 8 screenshots
• Full rights to rebrand, reskin, extend and publish anywhere

Please note: this is a source code template, not a hosted game. Basic JavaScript knowledge is helpful for customization. If you have questions, use the contact form on the site, I usually reply within 24 hours.