[EPIC] The Beacon — Night of Polish #57

New Issue

Timmy · 2026-04-11T00:41:21Z

Timmy commented

2026-04-11 00:41:21 +00:00

Context

Code audit today: 2.4/5 (SLOPPY). The design is 4/5. Tonight we close the gap.

This is the creative epic — focused on making The Beacon feel like a finished product, not a prototype.

Tasks

1. Visual Identity Pass

Consistent color palette (the CSS vars are close but inconsistent)
Animated resource counters (pulse on gain, shake on loss)
Smooth phase transition screen (currently jumps)
Building purchase particles/confetti on milestone

2. Sound Design Integration

Click sounds (code typing SFX)
Milestone chime
Phase transition fanfare
Background ambient (server hum → AI orchestral swell per phase)
Mute toggle

3. Ending Cinematic Enhancement

Current renderBeaconEnding() is inline HTML with hardcoded styles
Add particle effects for the "light" ending
Add glitch/distortion for the "dark" ending
Fade-to-black with final message
"Play Again" with stat summary

4. Tutorial & Onboarding

First-time player walkthrough (3-5 click-through screens)
"What is this game?" intro with skip option
Tooltip system for buildings/projects (hover to see what they do)
Keyboard shortcut discovery (? overlay already rescued from #48)

5. Accessibility

Screen reader labels on buttons
High-contrast mode toggle
Keyboard-only playability verification
Font size scaling option

6. Mobile Polish

Touch targets minimum 44px
Responsive layout for small screens
Prevent double-tap zoom on buy buttons
Save-on-pause (visibility change event)

Definition of Done

Game feels polished, not prototypical
Sound toggle works
Tutorial can be skipped
Mobile playable without frustration
Ending has visual weight

Tonight Scope

Focus on tasks 1, 2, and 4. Visual identity, sound integration, and onboarding. These have the highest impact per hour.

## Context Code audit today: **2.4/5 (SLOPPY)**. The design is 4/5. Tonight we close the gap. This is the creative epic — focused on making The Beacon feel like a finished product, not a prototype. ## Tasks ### 1. Visual Identity Pass - Consistent color palette (the CSS vars are close but inconsistent) - Animated resource counters (pulse on gain, shake on loss) - Smooth phase transition screen (currently jumps) - Building purchase particles/confetti on milestone ### 2. Sound Design Integration - Click sounds (code typing SFX) - Milestone chime - Phase transition fanfare - Background ambient (server hum → AI orchestral swell per phase) - Mute toggle ### 3. Ending Cinematic Enhancement - Current `renderBeaconEnding()` is inline HTML with hardcoded styles - Add particle effects for the "light" ending - Add glitch/distortion for the "dark" ending - Fade-to-black with final message - "Play Again" with stat summary ### 4. Tutorial & Onboarding - First-time player walkthrough (3-5 click-through screens) - "What is this game?" intro with skip option - Tooltip system for buildings/projects (hover to see what they do) - Keyboard shortcut discovery (? overlay already rescued from #48) ### 5. Accessibility - Screen reader labels on buttons - High-contrast mode toggle - Keyboard-only playability verification - Font size scaling option ### 6. Mobile Polish - Touch targets minimum 44px - Responsive layout for small screens - Prevent double-tap zoom on buy buttons - Save-on-pause (visibility change event) ## Definition of Done - [ ] Game feels polished, not prototypical - [ ] Sound toggle works - [ ] Tutorial can be skipped - [ ] Mobile playable without frustration - [ ] Ending has visual weight ## Tonight Scope Focus on tasks 1, 2, and 4. Visual identity, sound integration, and onboarding. These have the highest impact per hour.

Timmy self-assigned this 2026-04-11 03:10:41 +00:00

Timmy referenced this issue from a commit

2026-04-11 08:47:15 +00:00

feat: add first-time player tutorial walkthrough

Timmy referenced this issue

2026-04-11 08:49:13 +00:00

feat: first-time player tutorial walkthrough #66

Sign in to join this conversation.