RogueTaire: Solitaire Quest — Roguelike Klondike & 8-Bit Synth (v3.0)
Klondike solitaire fused with Slay the Spire–style directed graph maps, 8 rule-breaking relics, a 32-node Canvas skill tree, and an 8-track Web Audio chiptune synthesizer.
- Role
- Game Designer, Chiptune Composer & Frontend Developer
- Material / Stack
- Vanilla ES6 · Mulberry32 PRNG · HTML5 2D Canvas · Web Audio API · CSS3 Pixel Art
- Process / Engineering
- Roguelike loop design, procedural graph generation, audio synthesis & touch/pointer UX
Tools
Deliverables
Complete browser-playable roguelike solitaire with meta-progression tree and 8-bit soundtrack
3 / 4,548
Files & Lines of Code
app.js (3,086) · style.css (1,134) · index.html (328), zero deps
32 · 8 · 3
Upgrades · Relics · Potions
Permanent 6-category skill tree + active rule-bending mutators
8 Pistas
8-Bit Chiptune Synth
64-step 3-voice Web Audio sequencer per track with zero MP3s
12 Vistas
Screens & Local Profiles
3 table themes, 5 card backs, 4 achievements & exact mid-run resume
LIVE INTERACTIVE RUNTIME (EMBEDDED SANDBOX)
Visual Documentation & Diagrams
01 / Brief & Challenge
Reinvent classic deterministic Klondike Solitaire into a replayable roguelike adventure featuring floor-by-floor node progression, rule-breaking build synergies, seed-reproducible runs, and pixel-art polish with an original soundtrack—built completely without external game engines or audio assets.
02 / Engineering & Process
Engineered a Klondike core over a pooled 52-card DOM layer using GPU transforms, double-tap quick moves, Pointer Events drag-and-drop, and deadlock detection. Layered a Mulberry32 seeded PRNG driving 6-layer directed graph maps (#map-canvas), floor bosses with cursed/frozen cards, a 32-node Canvas skill tree (#tree-canvas), and a 3-voice Web Audio chiptune sequencer.
03 / Outcome & Impact
Full immediately playable release (v3.0) featuring 12 integrated screens, daily seeded runs (DAILY-YYYY-MM-DD), 3 difficulty modes, multi-user persistence with mid-board run resume, and 8 context-aware chiptune tracks for menus, floors, shops, and bosses.
04 / TECHNICAL ARCHITECTURE & SUBSYSTEMS
Deterministic Mulberry32 PRNG & Daily Seeds
seedPRNG() hashes any custom string into a 32-bit state stepped by Mulberry32 (0x6D2B79F5). Two players entering the same seed—or playing the DAILY-YYYY-MM-DD challenge—receive identical map topologies, events, and 52-card shuffles.
6-Layer Directed Graph Procedural Map
generateMap() builds 6 layers per floor (Battles, Events, Shop, Oracle, and Floor Boss at Layer 5), wiring directed edges cleanly with a zero-orphan guarantee on every next layer. renderMap() renders active and locked paths onto #map-canvas.
Klondike Core + Relics, Consumables & Bosses
Supports 3 difficulty modes (1-card or 3-card draw, hard-mode recycle cap), full Undo stack, smart Hints, cascade Auto-Complete, and deadlock detection with 'The Phoenix' deck-reshuffle revival. Mutated by 8 passive Relics, 3 Potions, and Bosses every 3 levels (Void Fog, Frozen Cards, 1-Recycle Cap).
32-Node Permanent Meta-Upgrade Tree (#tree-canvas)
Gem-driven permanent progression featuring 32 upgrades across Economy (8), Starter Relics (5), Board Rules (9), Suit Mastery/Combos (7), and Shop/Survival (3), switchable between filterable cards and an interactive Canvas dependency graph.
8-Track Web Audio Chiptune Sequencer
Zero external audio files. BGM_TRACKS defines 8 distinct 64-step compositions (135ms–195ms step tempo) synthesized live with 3 oscillators (Triangle lead, Square harmonic arpeggio, Sine bassline), plus ascending COMBO_NOTES foundation streaks and haptics.
Cosmetics, Multi-User Profiles & Mid-Run Resume
Persistent localStorage profiles (roguetaire_users, roguetaire_audio) storing lifetime stats, 4 Gem-rewarding achievements, 3 table themes (Classic Felt, Synthwave, Dark Dungeon), 5 card backs, and exact mid-board + map run resumption.
05 / SYSTEMS DESIGN & PROGRESSION ECONOMY
| System | Content | Rules / Mechanics | Strategic Impact |
|---|---|---|---|
| Passive Relics (8) | Midas Hand, Chromatic Chaos, True Sight, Canvas Scissors, The Magnet, Chrono Clock, Ace Magnet, Golden Chalice | Purchased with run Gold in Shops, granted by the Crystal Altar, or equipped at run start via Meta-Upgrades. | Break core Klondike rules (bypass alternating colors, place any card in empty columns, double foundation gold). |
| Consumables & Events (3 + 3) | Purify Potion, Transmute Wand, Seer's Eye · Mystic Hermit, Gambler Goblin, Crystal Altar | Single-use tactical buttons on the board HUD plus risk/reward narrative choices at event nodes. | Rescue deadlocked boards by flipping card colors, cleansing curses, or revealing hidden tableau cards. |
| Bosses & Curses | Lvl 3 (Void Fog), Lvl 6 (Frozen Wind), Lvl 9+ (Captive Deck) + Cursed Cards (Lvl 4+) | Scale from 1 cursed card (Lvl 4–6) to 3 (Lvl 10+); every 3rd level applies global floor-boss mutators. | Force tactical route planning through Shops and Oracles before reaching the Layer 5 Boss node. |
| Meta Skill Tree (32 Skills) | Economy (8), Starters (5), Board (9), Mastery (7), Shop/Survival (3) | Permanently unlocked with Gems; includes X-Ray, Stock Peek, Free Hints, and Phoenix second-chance revival. | Turn defeated runs into compounding permanent power and specialized deck-control playstyles. |
| 8-Bit Music Engine (8 Tracks) | menu, game_field, game_shadow, boss, game_cyber, boss_frost, game_abyss, shop | Automatic track switching per active screen and floor depth; persistent global Mute & BGM toggles. | Complete retro chiptune identity with zero network latency and zero downloaded audio files. |
06 / MODULAR SOURCE CODE MAP
| Module / Path | Architectural Role | Implementation & Detail |
|---|---|---|
| RogueTaire/app.js (3,086 LOC) | Unified Game Engine, PRNG, Graph & Audio | Houses all data registries (RELICS_DB, CONSUMABLES_DB, EVENTS_DB, UPGRADES_DB, BGM_TRACKS), Klondike rules, Mulberry32 PRNG, and Canvas map/tree renderers. |
| RogueTaire/style.css (1,134 LOC) | Pixel-Art Visual System, Themes & Animations | Responsive layouts across 12 screens, 3 table themes, 5 CSS card backs (including holographic), glow states, error shakes, and floating gold text. |
| RogueTaire/index.html (328 LOC) | 12-Screen DOM Shell, HUD & Canvas Layers | Defines login, main menu, #map-viewport (#map-canvas), events, upgrades (#tree-canvas), shop, cosmetics, achievements, board (#card-layer), game over, win (#victory-canvas), and help. |
07 / RELEASE EVOLUTION & ENGINEERING AUDIT
Directed-Graph Procedural Map, 32-Node Skill Tree & 8-Track 8-Bit Soundtrack
- Added 6-layer Slay the Spire–inspired floor map generator with zero-orphan graph wiring rendered onto #map-canvas.
- Expanded permanent meta-progression to 32 upgrades with dual view (filterable cards + interactive #tree-canvas dependency graph).
- Built 8-track 64-step Web Audio chiptune synthesizer (Triangle, Square, Sine voices), ascending combo audio, and mobile haptics.
- Shipped Pointer Events drag-and-drop + double-tap controls, keyboard shortcuts, Mulberry32 daily seeded runs, and 5 unlockable card backs.