BITESIZE READING LIBRARY — V4.8.2 STUDIO FOLDER REPAIR
====================================================
This patch updates Reading Library 4.8.1's Smart Studio Installer.
It does not contain a licensed Reading Studio product and does not replace your original Studio ZIP.

WHAT WAS IMPROVED
- A new folder-picker ID avoids the Chrome/Edge last-used-directory bookmark saved by the older installer.
- The picker starts in Downloads when no previous folder handle is known, or at a remembered folder when available. Browser security still requires you to authorise a folder the first time.
- Choose either "Reading Library Files" (recommended), or the folder immediately above it. If the parent was chosen, the installer automatically finds "Reading Library Files" inside.
- A write-access check runs before extracting any Studio files.
- Folder-not-found, permission and disk-space errors now identify the operation and (when applicable) the exact file being installed.
- A successful installation verifies the Teacher Mode launch file exists and is not empty.
- Your authorised folder is remembered locally where Chrome/Edge allow it. Later imports automatically install without asking again while access remains authorised.

HOW TO INSTALL THE PATCH WITHOUT LOSING DATA
1. Close Reading Library. Make a backup copy of your current "Reading Library Files" folder.
2. Extract the UPGRADE_ONLY ZIP next to the existing "Reading Library Files" folder, combining/replacing the specified files, NOT extracting the ZIP inside "Reading Library Files" to create a second nested copy.
3. Reopen START_READING_LIBRARY.html in recent Chrome or Edge.
4. Go to My Library and open the Headless Horseman Studio card (the package already imported in v4.8.1 should remain there).
5. Click "Finish Studio setup". Select the actual "Reading Library Files" folder: it contains START_READING_LIBRARY.html and a System subfolder. Alternatively select the immediate parent folder.
6. Approve Chrome/Edge's write permission, allow extraction to finish, then open Teacher Mode.

IF YOU SEE ANOTHER ERROR
- Note the newly displayed file/directory name and where installation stopped. This will help distinguish an out-of-date folder permission from inaccessible or cloud-synchronised directories.
- If the Library folder has been moved, renamed or placed inside OneDrive/school-managed storage, first test with a local folder you can edit, keeping the original folder's contents together.
- Do not select the Studio ZIP or System/studios as the Library folder.
- Opening Reading Library with a different browser profile or clearing browser storage may require granting permission again. Browser storage also holds classes/assessment data; do not clear it casually.

BROWSER LIMITATION
- An HTML file cannot silently point a system folder picker to its own location and grant itself local-file write permission. These protections are enforced by the browser.

TESTING
- JavaScript syntax checked with Node.js.
- Real Headless Horseman package (102 files) passed simulated File System Access installation; Teacher Mode launch file verified.
- Incorrect folder and missing launch page rejected.
- Parent folder auto-detection and NotFoundError filename diagnostics passed.
- Direct native Windows/macOS folder-picker tests were not available in this environment. Test on a normal desktop Chrome/Edge installation before publishing to customers.

© 2026 Bitesize Education
