Roll back to the stable version

If a recent BetterCampus update introduced a bug or broke a feature you rely on, you may want to go back to an older version. This guide explains your options and walks through the rollback process.

Before you roll back

Rolling back is an advanced process. Try these easier steps first:

• Check for a quick fix. Many bugs get patched within a few days. Check the Chrome Web Store page to see if a newer version is available.

• Temporarily disable the extension. Go to chrome://extensions, find BetterCampus, and toggle it off. This stops the bug without uninstalling.

• Report the issue. Email [email protected] or open an issue on GitHub. The team monitors reports and often releases fixes quickly.

How rollback works

BetterCampus updates automatically through the Chrome Web Store. You cannot choose an older version from the store directly. To roll back, you need to:

1. Download the source code for an older version from GitHub

2. Load it as an "unpacked extension" in Chrome's Developer Mode

This replaces the auto-updating extension with a manual one. You won't receive automatic updates until you switch back to the store version.

Roll back step by step

1. Go to the BetterCampus GitHub repository.

   Visit github.com/UseBetterCanvas/bettercanvas.

2. Find a stable older version.

   Click "Commits" to view the change history. Look for a commit from before the problematic update. Each commit shows a message describing what changed (for example, "5.12.6" or "Fixed dark mode bug"). Click the commit to view the code at that point in time.

3. Download the source code.

   On the commit page, click "Code" and select "Download ZIP". Extract the ZIP file to a folder on your computer.

4. Remove the current extension.

   Open chrome://extensions in your browser. Find BetterCampus and click "Remove". This uninstalls the store version.

5. Enable Developer Mode.

   On the chrome://extensions page, toggle the "Developer mode" switch in the top right corner.

6. Load the unpacked extension.

   Click "Load unpacked". Select the folder you extracted from the ZIP. The extension will appear in your list and work immediately.

7. Verify the version.

   Click the BetterCampus icon in Chrome and check that the features work as expected. The extension is now running the older code you downloaded.

Risks and limitations

• No auto-updates. You need to manually check for updates and repeat this process if you want a newer version later.

• Security considerations. Only download code from the official BetterCampus GitHub repository. Do not load extensions from untrusted sources.

• Settings may reset. Some settings or stored data might not carry over between versions. You may need to reconfigure themes or preferences.

• Sync breaks. If you use Chrome sync for extensions, the unpacked version will not sync across your devices.

Switch back to the store version

When you're ready to return to auto-updating releases:

1. Go to chrome://extensions

2. Find the unpacked BetterCampus extension and click "Remove"

3. Visit the Chrome Web Store page

4. Click "Add to Chrome" to reinstall the official version

When rollback doesn't work

If you're still experiencing issues after rolling back, the problem may not be the extension version:

• Clear your browser cache. Go to chrome://settings/clearBrowserData and clear cached images and files.

• Check Canvas itself. Try loading Canvas without BetterCampus enabled to see if the issue is with Canvas rather than the extension.

• Try another browser. Install BetterCampus on Firefox to test whether the issue is browser-specific.

If nothing works, contact the BetterCampus team at [email protected] with details about your browser version, Canvas URL, and what you're experiencing.