Skip to content

Great Reading Adventure v4.0.0-beta2

Choose a tag to compare
@k7hpn k7hpn released this 21 May 22:10

Release Notes: 4.0.0-beta2


The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out for an overview of its functionality and capabilities.


These release notes accompany 📚 The Great Reading Adventure version 4.0.0-beta2 which can be downloaded from GitHub!

Avatar assets extracted from Glitch the Game are packaged in Instructions for importing these avatars can be found in the “Adding Avatars” section of the manual.


There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Upgrading is possible from deployed instances of version 4. Note that during the upgrade there will be an interruption in service so it may be ideal to schedule this upgrade in off hours. To upgrade from prior versions (i.e. 4.0.0-beta1) follow these steps:

  1. Back up the database and the files that comprise the Web site.
  2. If you have modified any files in the application (such as .cshtml Razor template files), please make a note of which changes you’ve made, these changes will have to be performed again. Changes to the shared directory (such as to style.css or uploaded files) will be maintained.
  3. Replace the application files with the files from this release. Ensure that your shared directory is not overwritten when replacing application files.
  4. The appsettings.json file in the application folder will be replaced when you copy in files from the release. If you modified this file please compare to the file you backed up in the first step above to ensure any configuration changes you made initially are set in the new file. If you added an appsettings.json file in the shared directory with your settings it will not be overwritten and you shouldn’t need to change any settings.
  5. Load the site. It will take longer than normal as the database is upgraded (you can see evidence of the database upgrade in the log file in shared/logs).


For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including the Microsoft .NET Core 1.1 framework and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Notable changes in this release:

  • Households can now be upgraded to groups by administrators regardless of household size
  • Structured data for events
  • Friendly 404 page
  • Bundled CSS and JS assets (smaller and fewer files)
  • Added the ability to set a culture for displaying dates and times (defaulting to ‘en-US’ with 12-hour times)
  • Automatically select School District during registration if there’s only one
  • Mission Control management of point translations, authorization codes, roles, participant role assignments
  • Ability to send test emails from Mission Control
  • Vendor code improvements (reports, additional email token)
  • Fixed issues with household leads and groups in Mission Control

For more detailed information about changes in this release please review the change log.

Known issues

Here’s a selection of some notable currently-known issues:

  • Once a broadcast is created it cannot be deleted, only superseded with subsequent broadcasts (issues #308 and #309).
  • Avatar management is designed to use our Glitch avatar package, full avatar management isn’t functional yet (issue #261).

For up-to-date information about known issues please refer to the forum and the GitHub issue list.