← Back home

Release Notes

What's new in Guess the Frame.

v1.7.0

v1.7.0September 30, 2026

v1.7.0

Major gameplay overhaul introducing saga-aware answer rules, accuracy scoring, difficulty improvements, and a richer admin film management experience.

✨ Features

  • Game: Accuracy bonus awarded based on how precise a correct answer is
  • Game: Per-difficulty answer rules supporting saga + number format; aliases removed
  • Game: Original title shown first on reveal, with the English title displayed underneath for non-Latin-script films
  • Game: English title shown on reveal when the original title is not in Latin script
  • Game: Stricter blockbuster floor on EASY difficulty with stepped fallback logic
  • Game: Genre relevance, frame difficulty, Cinephile level, and an improved hint system
  • Game: 30 seconds per image by default with earlier hint triggers at 25 / 45 / 60 % of elapsed time
  • Import: Each movie's saga is now stored from its TMDB collection metadata
  • Admin: Film detail panel displays fame, saga, and difficulty rank
  • Admin: Difficulty badges shown in the film carousel with a simpler image-adding flow
  • Admin: Films page uses full screen width with a roomier image manager
  • Admin: Details panel scales to the width of a stat card on large screens
  • Admin: Filter films by completeness status

πŸ› Fixes

  • Admin: Unauthenticated API calls now correctly return 401 instead of 500
  • Game: Stricter and more consistent title normalization
  • Game: Titles in every script are now accepted; the same title hint is applied uniformly across all films

πŸ”§ Internal

  • Game: Fame bias refactored to represent a direction rather than a weight
  • CI: Production environment secrets are now injected into the VPS .env file on deploy
  • Docs: Analysis and plan documented for title matching, accuracy scoring, and i18n
  • Docs: Matching plan revised to reflect no-aliases, saga + number, and English title on reveal
  • Docs: Difficulty rules panel in game settings planned and documented
  • Docs: Party generation v2 spec added covering genres, image difficulty, and hints

Full changelog: v1.6.0...v1.7.0

v1.6.0

v1.6.0September 24, 2026

v1.6.0

Major homepage and quiz authoring overhaul, including a new AI quiz generator, curated editorial shelves, AI-designed quiz covers, and reworked admin screens.

✨ Features

  • Added a quiz generator with three recipes for automated quiz creation
  • Quiz covers are now AI-designed rather than picked from a quiz's own frames
  • Players are no longer shown a quiz's own frames during gameplay
  • Homepage now features a curated, switchable editorial shelf
  • Announcements have been folded into the Homepage screen
  • Homepage no longer requires a database connection at build time
  • Reworked admin custom-quiz screens with improved UX
  • Reworked admin Players list and detail screens
  • Reworked admin Parties list and detail screens

πŸ› Fixes

  • Fixed the TMDB recipe and ensured films are never repeated within a quiz

πŸ”§ Internal

  • AI quiz generation now uses Claude Sonnet instead of Opus to reduce cost
  • AI quiz generation runs at low effort mode to further reduce cost

Full Changelog: https://github.com/your-org/guess-the-frame-js/compare/v1.5.0...v1.6.0

v1.5.0

v1.5.0September 16, 2026

v1.5.0

This release brings a full homepage redesign centered around a live hero preview, a brand-new Streaming theme, language flag indicators for accepted frame titles, and a collection of UI and branding polish fixes.

✨ Features

  • Rebuilt the landing page around a tilted hero preview with a themed game screenshot backdrop
  • Added a new Streaming theme with a laptop icon
  • The game now shows which languages a frame's title is accepted in
  • Hero preview renders the full game screen inside a browser frame
  • Action cards on the homepage now have more breathing room, with the frame brought into view

πŸ› Fixes

  • Logo now correctly displays the icon alongside a themed wordmark in top bars
  • Streaming theme icon corrected to use the laptop (previously showed a cathode-ray tube or play button)
  • Nameless hosts are now prompted for a nickname on room creation instead of being stranded

v1.4.0

v1.4.0September 15, 2026

v1.4.0

Introduces durable browser identity with optional account linking, alongside several admin panel and badge judging fixes.

✨ Features

  • players: Each browser is now assigned a durable identity that persists across sessions. Players can optionally claim that identity by linking an account.

πŸ› Fixes

  • badges: Badges are now judged at the moment their answer becomes known, rather than re-evaluated after every game event, preventing premature or missed awards.
  • admin: The player list is now ordered by most recent activity, making it easier to see who has been playing lately.
  • admin: Returning players are correctly counted as a single person in the admin panel, rather than being counted once per browser session.

πŸ”§ Internal

  • docker: Dropped the legacy standalone Postgres service; the stack now uses the shared shared-postgres service.
  • docs: Updated README for improved clarity and conciseness.

Full changelog: v1.3.0...v1.4.0

v1.3.0

v1.3.0September 12, 2026

v1.3.0

A major visual and UX overhaul across the lobby, game, results, and admin panel, plus security hardening and several bug fixes.

✨ Features

Game

  • Score a correct answer in three animated parts for a more satisfying reveal
  • Make a correct answer land with improved visual feedback
  • Turn the round break into a real cinematic reveal

Lobby

  • Rebuild the lobby as a full-width desktop app shell
  • Separate the two ways to pick frames and apply settings live
  • Make your own chat messages visually recognisable

Results & XP

  • Rebuild the end-of-game screen around its actions
  • Flatten the XP level curve for a more balanced progression
  • Pay out XP owed when an account is created after the game ends

Admin

  • Add a global command palette (Cmd/Ctrl+K)
  • Triage feedback instead of just listing it
  • Show what deleting a movie costs before confirming
  • Manage movie images from the admin (remove, restore, edit)
  • Soft-delete movie images so the importer cannot bring them back
  • Show actionable counts in the admin navigation
  • Rework the admin shell into a proper app sidebar
  • Paginate films by tens and surface localised title languages
  • Redesign films list with stats bar, table/gallery toggle, and a compact quick-view panel
  • Redesign admin films list with a visual grid and drawer editing
  • Custom quiz frame model rework with creation assistance
  • Overhaul the movie import workflow

πŸ› Fixes

Game & Lobby

  • Keep the results on screen when signing up from the results screen
  • Keep a running game inside the viewport
  • Make the filter fallback reachable and resync a rejected change
  • Keep the wrong-answer verdict as one phrase
  • Show players every filter and sync the card to the theme
  • Stop the player list clipping the avatar rings

Admin

  • Stop the imports page reporting a hydration mismatch
  • Search parties by nickname, as the placeholder promises
  • Keep the imports auto-refresh on the page you are currently viewing
  • Give the imports list the same paginator as every other page
  • Highlight the sidebar item for the page you are actually on
  • Make the film image carousel arrows reliable
  • Fix checkbox text overflow and admin layout shell
  • Make genre badges visible in the film detail panel

Security

  • Raise PBKDF2 to 600 000 iterations and transparently upgrade existing hashes on login
  • Rate-limit the admin login endpoint

General

  • Silence the data-theme hydration mismatch on every page
  • Harden staging .env DB-name substitution in the deploy script
  • Stop the staging deploy racing itself over the database check

πŸ”§ Internal

  • Replace any types that were hiding real bugs
  • Apply shared page shell to admin detail, form, and import pages
  • Add shared PageHeader/PageContainer components and apply to admin list pages
  • Unify pagination across all admin list pages
  • Rework the films screen to match the reference layout
  • Unify admin navigation, layout width, and Suspense usage
  • Request TMDB artwork at the size it is actually displayed (perf)
  • Stop loading every game event to render the Parties list (perf)
  • Add test coverage for admin auth, search, and write paths

v1.2.0

v1.2.0September 10, 2026

v1.2.0

A major UI overhaul release featuring redesigned lobby, game HUD, and replay modal, alongside numerous game flow improvements and bug fixes.

✨ Features

  • Redesigned the room lobby with an 'Arcade Cinema' look
  • Reworked lobby into a 'Cinema Classic' settings-row layout
  • Redesigned the in-game round screen into a proper game HUD
  • Redesigned the replay modal to better fit its content and match the game HUD
  • Added early round-end support, a skip button, rebalanced quiz difficulty, and renamed 'Rec' to 'Save'
  • Added BETA badge, TMDB attribution, centered theme FAB icon, and polished auth modal

πŸ› Bug Fixes

  • Added missing PasswordResetToken migration
  • Based pre-round countdown purely on client-side elapsed time for accuracy
  • Clamped pre-round countdown display to never show 4 or skip 1
  • Disabled Next.js image optimizer to fix logo hanging on staging
  • Made quiz generation actually favor well-known movies
  • Fixed settings divider/toast duplication and unreliable game-start transition
  • Fixed quiz theme picker being clipped by collapse and stuck on 'Loading…'
  • Cleaned up lobby header alignment and clarified quiz-theme/settings split
  • Removed dead placeholder admin guard on import job detail page
  • Changed 'Next round in:' to 'Results in:' on the last round
  • Fixed game end persisting after the poster-reveal delay instead of before
  • Fixed the last round's poster reveal not showing before the scoreboard

Full Changelog: https://github.com/LoganBlack13/guess-the-frame-js/compare/v1.1.0...v1.2.0

v1.1.0

v1.1.0September 9, 2026

v1.1.0

This release introduces a revamped homepage with a feedback form, a new release notes page, and a staging environment, along with performance and visual fixes.

✨ Features

  • Modernized homepage with a new design and integrated feedback form
  • Added feedback admin view for reviewing submitted feedback
  • Added release notes page and robots.txt
  • Added staging environment at test.guessthefra.me

πŸ› Fixes

  • Removed homepage corner shapes for a cleaner visual appearance
  • Dropped blur()/backdrop-filter from homepage for improved rendering performance, preserving color via gradients

πŸ”§ Internal

  • Added manual CI workflow to sync staging database from production
  • Added and subsequently removed a read-only CI workflow to inspect VPS Traefik config

Full Changelog: https://github.com/LoganBlack13/guess-the-frame-js/compare/v1.0.0...v1.1.0

v1.0.0

v1.0.0April 7, 2026

v1.0.0

Initial release of guess-the-frame-js β€” a real-time multiplayer movie frame guessing game built with Next.js, WebSockets, Prisma, and Docker.


✨ Features

  • Real-time multiplayer game rooms with WebSocket-powered state sync, reconnection support, and disconnected player indicators
  • Guest play and full account system (signup, login, forgot password) with IP-based rate limiting on auth endpoints
  • XP and level progression system for signed-in accounts with animated XP gain on the results page
  • Badge system with declarative evaluator, discovery-only badges, "First Blood" badge, and in-progress tracking
  • Replay functionality with modal display, nickname overlay, and corrected timeline starting from game start
  • Private room password protection and configurable 10-player room capacity limit
  • Genre and decade filters for game settings
  • Custom quiz support with rating system and admin quiz management
  • Admin panel with authentication, player management, parties page, badge creation/editing, and import job management
  • Real-time import job updates via WebSocket with progress animations and skipped movie tracking
  • Round-end card with movie poster and countdown, podium display with celebrations, and 1v1 duel display for 2-player games
  • Live event feed in chat for correct guesses and round starts
  • Avatar glow and float animation on correct guess
  • Dynamic movie title fonts using authentic movie-style fonts
  • DVD overlay with responsive scaled positioning
  • Player profile page with tabs, stats, avatar grid, pagination, XP display, and badge sharing
  • Countdown display when a game starts in the playing phase
  • Weighted random party generation with movie deduplication and discovery diversity
  • Toast notification system moved to top-center with a global manager
  • Docker support with Dockerfile, docker-compose files, and log rotation
  • Admin import job form with minimum rating field and enriched backdrop support
  • Reusable UI components: Pagination, EmptyState, PlayerCard, theme selector

πŸ› Fixes

  • Send full game state to reconnecting players
  • Fixed replay timeline incorrectly starting from room join instead of game start
  • Fixed username handling for invite links and account loading race condition
  • Fixed router-not-defined error in GamePane
  • Fixed badge display issue β€” use unlockedAt: null to correctly track in-progress badges
  • Fixed duplicate counting and backdrop enrichment in the import job
  • Added image error handling with retry logic for game frames
  • Fixed party randomization algorithm
  • Awaited params in Next.js 15 dynamic routes to resolve async warnings
  • Wrapped AuthModal in Suspense boundary to resolve useSearchParams error
  • Fixed ROUND_STARTED events shown correctly in admin timeline with card layout
  • Used totalRounds instead of rounds on the public state type
  • Resolved all ESLint errors blocking CI
  • Removed obsolete ts-expect-error (aliases relation is now properly typed)
  • Included scripts/ directory in Docker image for admin and maintenance tasks
  • Fixed real-time import job WebSocket updates

πŸ”’ Security

  • Added IP-based rate limiting to forgot-password and signup endpoints
  • Protected /api/import-update with admin authentication

πŸ”§ Internal

  • Added GitHub Actions deployment workflow
  • Used Prisma.sql for multi-database compatibility
  • Refactored WebSocket server rooms handler and removed legacy code
  • Extracted Replay into an independent component
  • Extracted pagination into a reusable component
  • Homogenized admin pages layout with search bars and standardized empty states
  • Cleaned deprecated UI files
  • Added .env.example and updated documentation
  • Pre-production hardening and code quality improvements
  • Updated project dependencies
  • ESLint runs in CI only; ignored during Docker build
  • Stored player nickname in GameEvent payloads for replay accuracy
  • Aligned player stats calculation between admin and profile pages

Released by Logan Black β€” March 2026