Bebop Puzzle

Boardgame Kit

Grid options now go from 2 to 6 chords (target column always included)
Cut-out pieces are sized to fit the board grid cells exactly
Cleaner minimalist board styling — light background with thin gray cell outlines
Prints in landscape on a single letter page so the board and pieces are as large as possible
Removed printed rules and labels for a clean, ready-to-cut sheet

Goals & Missions

Added a printable Boardgame Kit from the main menu
Boardgame Kit includes empty grids, per-piece copy controls, paginated cut-out sheets, and table rules
Daily Missions now unlock from Chapter 2 with progress cards on the chapter page
Completed missions now show persistent check badges on mission cards
Mission completions trigger a compact top-screen badge during play
Added a visible next-goal panel so players always know what to do next

Solve Feedback

Updated star copy to match listen-based scoring
Added richer resolution feedback when a melody solves
Simplified the Complete screen into a minimal result, stats, and next step
Improved success feedback for first clears, star upgrades, and new bests
Refined chapter page hierarchy and removed repeated chapter/progress information

Performance & Polish

Throttled drag snap checks to reduce jank during mouse and touch dragging
Cached drag grid metrics while dragging instead of recalculating every move
Cleaned up stale auto-play, tutorial, and screen-transition timers
Reduced repeated playhead DOM scans during melody playback

Gamification

Star rating now based on listen count (not time) — rewards deep listening
Wrong placements give targeted feedback ("Right piece! Try flipping" etc.)
Chapter completion shows jazz flavor text connecting skills to real artists
Daily Challenge — a new seeded puzzle every day on the landing page
Streak counter tracks consecutive practice days with milestone achievements
Best listen count stored and shown per level
Composer Mode now unlocks after Chapter 3 (was: all chapters)
Jam Session intro screen explains distractor pieces and listen limits

Bug Fixes

Fixed Sound Design panel invisible borders (missing CSS variables)
Fixed hint popup and changelog animation jump (pop-in translate)
Fixed BPM not resetting between levels (compounding slowdown)
Fixed tray piece vanishing when dropped on occupied column
Fixed hint adding pieces beyond tray capacity
Fixed rapid drag during tray collapse causing index mismatch
Fixed guided mode timeouts surviving map navigation
Fixed success overlay persisting after navigating to map
Fixed modal overlays not scrollable on short viewports

UI/UX

Tray now fits 4 pieces on both desktop and mobile (compact mode)
Mobile: craft table wraps to second row for more tray space
All touch targets meet 44px minimum (back buttons, tabs, sliders)
Slider thumbs enlarged from 16px to 28px for easier grabbing
All font sizes meet 10px readable minimum
iOS Safari 100dvh fix for address bar cutoff
Debounced window resize handler

Audio

Fixed echo/overlap when celebration melody played over unfinished playback
Reward samples now resolve to the target note (sounds complete)
Non-final correct placements play that column's notes as confirmation
Tray piece hover preview shows a gold fill animation synced to audio

Gameplay Flow

Melody auto-plays when entering a level (except the very first tutorial)
Play button turns into a skip button during celebration
Click anywhere to skip the celebration and jump to results
Chapter map navigates to the correct chapter after reward screens

Craft Table

Drag pieces back out of the craft drop zone to return them to your hand
Craft output pieces stay draggable after a cancelled drag
Fixed piece duplication bug when dragging out of craft zone
Tray collapse animation when a piece is consumed (no more layout jump)

Labels & UI

Enclosure labels changed to "From Above"/"From Below"
"NEXT" badge on the first uncompleted level in the chapter map
Stronger gold pulse on playable levels
Chord labels highlight gold during melody playback
Play button pulses on level entry to attract attention
Enlarged "Next" button in piece intro screens
Star rating info button (tap to see how stars are earned)
One-time hint about between-grid snap positions

Tooltips & Tutorials

Tooltips persist until the user performs the action (no more auto-dismiss)
Flip hint triggers faster on tutorial levels (8s instead of 15s)
Ch1 Level 4 now always requires a flip to solve

Responsive

Improved small-screen layout: scrollable tray, min touch targets, craft overflow

Warmup Quiz Redesign

Welcome back quiz uses real piece thumbnails and mystery "?" card
Each variant shown as a separate choice for direction recognition
"More quiz" or "I'm ready" options after finishing — no auto-progress
Warmup triggers on Play button instead of page load

UX Improvements

Escape key dismisses any open overlay
Smooth fade-out transitions when closing overlays
Singing encouragement nudge on idle (35 unique messages)
Green outline on correctly placed pieces
Craft table hint gives missing piece directly to tray
Hover-to-play on tray pieces (hold 1s) replaces headphone icon
Tutorial spotlight properly highlights target elements

Bug Fixes

Celebration timeouts cleared when navigating away
Game complete "Back to Map" now goes to correct chapter
Warmup only quizzes pieces from completed intro levels
Missing CSS variables defined (--bg, --text, --font-display)
Tablet responsive breakpoint at 768px

Meet the Piece — Redesigned

2-part intro: explore piece variants first, then ear training quiz
Actual piece thumbnails replace generic icons
2-round quiz covers both variants with a mystery "?" piece
Congrats screen with "Ready" or "More Quiz" options

UI Polish

Headphone icon above tray pieces for audio preview
Tooltips stay anchored on browser resize
Centered play/pause icon in melody button
Removed note particle animations during playback

Bug Fixes

Reward screen description and Arpeggio tagline now display correctly
Ch.6 listen-limit tutorial appears before first play
Piece intro quiz elements properly hidden when inactive

Level Design

Jazz-themed level names across all 80 levels
Varied difficulty curves per chapter with breather levels
Chord progressions now use real ii-V-I patterns in key
Balanced star unlock thresholds

Onboarding

Progressive craft table introduction (hidden → flip → full)
Contextual tooltips teach flip and duplicate at the moment of need
"Sing It Back" encouragement after melody playback
Tap empty columns to hear what belongs there

New Piece Unlocks

Reward screen auto-plays the new piece's sound
Listen closely — each piece has its own melodic shape
One-word taglines replace text descriptions

Juice

Spring snap animation when pieces lock in
Green flash when pieces connect correctly
Note particles float upward during playback
Melody auto-plays with color pulses on level complete
3-tier star celebration (sparkles → confetti + "Perfect!")

Visual

Gold metallic shimmer on the title
Color-coded piece types in the tray
Piece type glow on placed grid pieces

Controls

F / D / C keyboard shortcuts for craft table

Build a table-ready Bebop Puzzle set.