# Changelog

# 4.1.0 (2025-08-11)

# Added

• Filters on locations page to show only locations without clues or markers, and full-text search.
• CSS cache busting to ensure styles are always up-to-date.

# Changed

• Upgraded from DaisyUI 4 to 5, and from TailwindCSS 3 to 4.
• Tailwind builds are now minified.

# Fixed

• Fixed incorrect view render on player check-in.
• Added early return on player start, so first error is shown.
• Build command

Full Changelog

# 4.0.1 (2025-07-23)

# Fixed

• Makefile for build output now works.

Full Changelog

# 4.0.1 (2025-07-20)

# Changed

• Updated package to v4 and migrated all imports to the new version.

Full Changelog

# 4.0.0 (2025-07-20)

This update introduces significant architectural changes to make the codebase easier to maintain, test, and extend.

# Added

• AccessService to manage user access control and permissions.

# Changed

• Breaking change: Removed locationID field from Reorder method in BlockRepository interface. Not needed as blocks are now always associated with a location.
• Breaking change: Moved docs service to internal/services for consistency with other services.
• Renamed handler subpackages to public, admin, and player for clarity and consistency.
• Handlers now define the interfaces they depend on, rather than relying on services to provide them. This improves testability and reduces coupling. Handlers are now plumbed directly in main.go and passed to the server, rather than being defined in the server package. This cuts down on plumbing.
• Refactored the GameManagerService into GameScheduleService, QuickstartService, InstanceSettingsService to improve maintainability and separation of concerns.
• Refactored the LocationService into InstanceSettingsService, LocationStatsService, and MarkerService.
• Refactored the GameplayService into CheckInService and NaivgationService to better separate concerns and improve readability.
• Refactored out deletion logic into a new DeleteService to handle deletion of any entity in the system that requires cascading deletes.
• Renamed AuthService to IndentityService to better reflect its purpose, and to avoid confusion with the new AccessService.
• Normalised error handling across all services to use a consistent pattern, especially with missing or invalid data.
• Moved interfaces from services into handlers.

# Removed

• ServiceResponse is gone! Use standard Go errors instead.
• GameplayService and GameManagerService are now split into multiple services, each with a single responsibility.

Full Changelog

# 3.10.0 (2025-07-10)

# Added

• Clue block! A new interactive content block that allows players to view clues for a price.
• Broker block! A new interactive content block that allows players to blindly trade points for clues.

# Changed

• Rearranged blocks into alphabetical order in the admin interface for easier navigation.
• Images in player content are now rounded.
• Videos in docs are now rounded.

# Fixed

• Bonus Points System: Fixed critical issues with bonus points calculation and recording:
  • Bonus points are now calculated correctly based on visit order (first visitor gets 2x, second gets 1.5x, third gets 1.2x points)
  • CheckIn records now store the actual points awarded to players instead of just base location points
  • Implemented hybrid points system for “check in and out” mode: bonus points awarded immediately at check-in, base points awarded at check-out completion
  • CheckIn records are now updated during checkout to show total points earned from location (bonus + base points)
  • Added comprehensive test coverage for bonus points functionality
• Removed the word “Block” from Quiz block title for consistency.

Full Changelog

# 3.9.2 (2025-07-02)

# Fixed

• Points now show in player footer
• Hide currently visiting in facilitators dashboard, if not used

Full Changelog

# 3.9.1 (2025-07-01)

# Fixed

• Scheduler parses dates correctly again.
• Map markers on hover now no longer steal focus on activity page.
• Indicator to set team name is now coloured.
• Notifications appear in the lobby.

Full Changelog

# 3.9.0 (2025-06-29)

# Added

• Quiz Block! A new interactive content block.
• Template links can now include hashes to specific locations, allowing admins to share direct links to specific parts of a game.

# Fixed

• Roadmap no longer shows completed items.
• Fixed preview mode crash when submitting correct answers to already completed blocks.
• Preview mode now correctly loads and displays instance settings (points, etc.) instead of using empty defaults.
• Lobby and next location pages now correctly handle preview mode.
• Clues now correctly save when added.
• Sorting block now correctly saves new items when added.
• Block content points are now updated live when changed in the admin interface.

Full Changelog

# 3.8.1 (2025-06-18)

# Fixed

• Fixed an issue where every clue was shown to every player #66.
• Blocks now keep their order when replicated for templates #68.
• Dependent/blocking settings were not being honoured or enforced #70.
• Minor bugs in template preview rendering

Full Changelog

# 3.8.0 (2025-06-16)

# Added

• User preferences system with customizable display name, theme selection, work type field, and email sharing controls.
• Settings page for users to manage their profile and preferences.
• Password change functionality for email-authenticated users with robust validation.
• Client-side theme management using localStorage for persistent theme preferences across sessions.

# Fixed

• An issue preventing new users from creating markerless locations has been resolved.
• Fixed theme flashing on page load by applying theme settings immediately in page header.
• Locations now save clues correctly.
• Locations now accept updates without coordinates, allowing for markerless locations.

Full Changelog

# 3.7.0 (2025-04-29)

# Added

• New Sorting Block, a quiz-type block that requires players to sort items in a specific order.
• Enhanced documentation system with missing page tracking and redirect support.
• Developer docs for Database Schema to provide a visual representation of the database structure.
• Developer docs for Data Flow to illustrate how data moves through the system.

# Changed

• Minor: Admin menu on mobile now has a more consistent look and feel with the public facing menu.
• Improved heading formatting validation in documentation pages.
• Block system respects Preview mode, enabling a completed block to be recompleted in preview mode.

# Fixed

• Documentation system now properly handles redirects to maintain links between pages.
• Tailwind now scans docs for classes to ensure all styles are applied correctly.

Full Changelog

# 3.6.0 (2025-04-20)

# Added

• Satellite map style and switcher for easier editing and viewing, especially for location with unmapped landmarks. Closes #39.

# Changed

• Minor: Anchor links in Docs now appear slightly different to the rest of the text for better visibility.

# Fixed

• Public auth template now requires authed var for correct rendering. Fixes issue with incorrect buttons on facilitator dashboard.
• Admin alerts to players are now easier to dismiss and a little harder to ignore #62.

Full Changelog

# 3.5.0 (2025-04-19)

# Added

• Templates System (#50):

  • Introduced Templates for reusing game setups. Templates can be created from existing games and launched into new instances.
  • Added support for shareable template links, including unique and “unlimited” options.
  • Admins can now manage templates (create, update, delete, rename) via a dedicated interface.
  • Share links load associated content (blocks, clues, markers), with appropriate handling for expired or missing templates.

• Preview System Enhancements:

  • Middleware now handles previewing of routes for players, locations, navigation, and check-ins.
  • Added context keys and logic to support admin previewing without triggering other middleware layers.

• Authentication Awareness:

  • Public pages now detect if an admin is logged in and adjust UI accordingly (e.g., showing admin button).

• Miscellaneous:

  • Added unit and integration tests for affected areas, including template and instance service, middleware, and preview systems.
  • Major updates to template pages, instance lists, modals, mobile responsiveness, and admin views.
  • Added skeleton loaders for media content to enhance perceived performance.

# Changed

• Renamed instances to games across UI and documentation for clarity.
• Improved service layering and dependency isolation in the template, instance, and user services.
• Refactored middleware to accept minimal interfaces, improving testability and reducing coupling.
• SQLite now uses Write-Ahead Logging (WAL) mode to avoid read/write contention.
• Lobby middleware now redirects and handles teams more efficiently.

# Fixed

• Cleaned up orphaned markers when locations are deleted.
• Ensured proper validation and error reporting across services.
• Fixed highlighting in navigation menus and corrected preview context logic.
• Corrected docs for Image Blocks to reflect new upload capabilities.
• Corrected docs for Installation instructions to include folder permissions for uploads.
• Preview system fixes #48 by enabling admins to interact with closed games.
• Fixed issues identified by golangci-lint, specifically using gosec, gocritic, bodyclose, whitespace (--fix), misspell, govet, unused, and errcheck.

# Removed

• Cleaned up debug code, placeholders, and commented-out logic.

Full Changelog

# 3.4.0 (2025-02-11)

# Added

• Content Blocks:

  • Divider Blocks to separate content blocks for better readability.
  • Alert Blocks for important messages.

• Uploads and Image Management:

  • Admins can now upload images to Image Blocks. Images by URL are no longer supported. #21. This lays a lot of groundwork for player image and video uploads in the future (#49)

• Game Enhancements:

  • Introduced support and interface updates for unmapped locations. #45
  • Added an IsMapped method on markers to check if a location is mapped.

# Changed

• Refactored URL generation, moving it out of the game manager and into the asset generator for better separation of concerns.
• Split game_manager_service into instance_service to improve maintainability.
• Refactored dependencies in services to reduce unnecessary coupling.
• Modified the quickbar to accept only an instance instead of the whole user object.

# Fixed

• Resolved an issue where duplicating locations did not copy clues and blocks. #52
• Fixed an issue where newly created blocks did not correctly replace the location ID.
• Ensured non-marker locations are disabled from rendering on maps. #45
• Fixed preview refresh issues after deleting a block.
• Addressed static analysis warnings for unused variables, comments, and ignored errors.
• Various minor typo fixes and documentation updates.

# Removed

• Cleaned up dead code and removed unused functions flagged by static analysis.
• Removed redundant code in templates and players.
• Removed unnecessary dependencies in services.

Full Changelog

# 3.3.0 (2025-02-05)

# Added

• Team Management Enhancements:

  • Added the ability to reset a team’s progress back to nothing. #54
  • Teams page now links to the team overview for quick access.
  • API: Implemented bulk deletion of check-ins by team codes.
  • API: Introduced bulk deletion of player states by team codes.

• Facilitator Features:

  • A new facilitator dashboard helps staff know the current progress of the game, reducing the need for practice communication. #56

• UI/UX Improvements:

  • Reset and delete actions for teams now require confirmation to prevent accidental data loss.

# Changed

• Deleting teams now refreshes the entire list view instead of partial updates for better consistency.
• Documentation improvements, including renaming files for clarity and fixing broken links.
• Improved wording and fixed minor UI inconsistencies across the platform.

# Fixed

• Ensured instanceID is correctly included when saving a check-in to prevent data inconsistencies.

Full Changelog

# 3.2.0 (2025-01-31)

# Added

• Players are now redirected to a dedicated end screen upon game completion. Included an easter egg when tapping the confetti icon. #53

# Changed

• Restyled the lobby and team name form for better clarity and user experience.
• Improved input validation and feedback messages, especially for check-in/out forms.
• Footer now includes team name, rules link, and team code for quick reference and is shown on more pages.
• Differentiated check-in elements for logged-in vs. logged-out players for a smoother experience.
• Style updates across the platform for better consistency and readability.
• Misc code refactors on internal services and handlers for readability and consistency.

# Fixed

• Fixed an issue where commas in filenames were preventing asset downloads. #57
• Fixed an issue where the team overview failed to render when a player had visited all locations.
• Resolved issues caused by blank sessions and edge cases that led to unexpected behaviour.
• Fixed a bug where check-in/out pages weren’t rendering if the player didn’t have a session.

Full Changelog

# 3.1.0 (2025-01-17)

# Added

• Instantly fit map bounds to neighbouring markers when adding locations (#44)

• Introduced the official project logo.

• Docs for Getting Started with Teams (#43)

# Changed

• Improved team activity overview for easier browsing and better visual clarity.
• Updated a documentation icon for consistency across the interface.

Full Changelog

# 3.0.1 (2025-01-14)

# Fixed

• Fixed an issue where the user could not switch instances. current_instance_id was blocked from updating in the database.

# 3.0.0 (2025-01-09)

# Added

• Contact Form:
  • Contact form messages are now sent to the platform admin instead of being thrown into the void. #23
• User Management:
  • New method for deleting users programmatically, including cascading logic to clean up dependent data.
• Documentation Enhancements:
  • Added roadmap/wishlist for brainstorming and tracking future features.
  • Developer-specific migration documentation, including instructions, testing steps, and explanations.
  • Included a history of Rapua as a reference for users and developers. #29
  • Minor changes to in-app hints and tips for better user experience.
  • Tests to ensure documentation is up-to-date and accurate; links are now checked for validity; pages must not be empty.
• Database Migrations:
  • Implemented a new migration system for database changes.

# Changed

• Breaking Changes:
  • Renamed cmd/game-server to cmd/rapua for consistency.
  • Major refactor of services and repository plumbing for better separation of concerns, maintainability, and scalability.
  • Repositories now accept a *bun.Tx for bulk deletions and Services now require a db.Transactor for beginning transactions.
  • All tests now use migrations to ensure a clean database state and non-global database vars.
  • Teams must now have UUID-based IDs for uniformity and scalability.
  • Models no longer support deleted_at; hard deletes are now the standard. Soft-deleted data was never used.
• Style Updates:
  • Docs now look better on mobile devices.
  • Submenu titles in documentation shrunk for consistency.
  • Content Blocks are now collapsible for better readability, and auto-collapse if there are more than 3 blocks.
  • Team CheckIns are now collapsible for better readability.

# Fixed

• The confirmation modal for deleting content blocks now triggers correctly. #36
• Resolved issues with block rendering and automatic updates. #34
• Map markers now show the same numbers as the location list for consistency.
• Ensured user registration failures clean up partially created user data. #40
• Registration emails are now automatically sent. #40

# Removed

• Unused methods and global variables related to the database have been removed for better maintainability.
• Unused methods from Blocks interface removed.
• Deprecated methods for database initialization and testing replaced with updated patterns.

Full Changelog

# 2.5.0 (2024-11-28)

# Added

• Team Features:
  • Teams can now set their own names directly within the platform.
  • Bulk deletion of teams is now supported for easier management.
• Interactive Map:
  • Map markers now display popups with names for better navigation and understanding of locations. Closes #25
• Documentation:
  • New public documentation system (Closes #19), including documentation:
    • User and developer guides.
    • Quickstart guide.
    • Tutorials, such as a Student Induction Tutorial.
  • “Docs” now takes the place of “Inspo” in the main navigation. Fixes #35
• API Updates:
  • Introduced new endpoints for managing teams in the Teams service, allowing programmatic creation, updates, and bulk deletion.
  • Added support for creating locations using existing map markers.

# Changed

• The team management interface has been redesigned for usability, using Hyperscript for interactivity.
• Game logic refactoring ensures more efficient handling of location relationships, including clues.

# Fixed

• Resolved an issue where marker names were not populating in the activity overview.
• Corrected a database query issue with an incorrect column name.
• Fixed an issue where game relationships weren’t fully loaded, affecting progression in specific scenarios.

Full Changelog