Changelog - Docs | Rapua
Rapua
Register Login

# 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:

  • 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:

# 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

# 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