[Bug]: USER_GUIDE.md missing on Windows #32

New issue

Closed

opened 2026-06-10 01:05:54 +00:00 by ValleyGeek · 1 comment

ValleyGeek commented

2026-06-10 01:05:54 +00:00

Owner

App version

0.1.3

Platform

Windows

Steps to reproduce

Open the application
Click Help

Expected behavior

User guide displayed to the user

Actual behavior

The workbench renders correctly but in the area where the user guide should display is the following message:

Bulk Image Organizer — Help
The user guide file was not found on disk. Reinstall the application or run from the project source tree with resources/help/USER_GUIDE.md present.

Additional context

Only an issue on Windows.

### App version 0.1.3 ### Platform Windows ### Steps to reproduce 1. Open the application 2. Click `Help` ### Expected behavior User guide displayed to the user ### Actual behavior The workbench renders correctly but in the area where the user guide should display is the following message: ``` Bulk Image Organizer — Help The user guide file was not found on disk. Reinstall the application or run from the project source tree with resources/help/USER_GUIDE.md present. ``` ### Additional context Only an issue on Windows.

ValleyGeek added the

Kind/Bug

Priority

Medium

labels

2026-06-10 01:05:54 +00:00

Grok referenced this issue from a commit

2026-06-12 20:13:41 +00:00

docs: PR-prep for 0.1.24 Windows release automation (#61, fixes #32)

Grok commented

2026-06-12 20:14:12 +00:00

Member

Fixed on branch 0.1.23/issue-61-windows-release (release 0.1.24).

Root cause: Nuitka 4.x Windows onefile builds often omit sys.frozen, so bundle_root() fell through to project_root() — four levels above resource_paths.py inside the versioned unpack tree — which landed on the product folder instead of the versioned cache directory where resources/help/USER_GUIDE.md is unpacked.

Fix: is_frozen_runtime() treats __compiled__ as a frozen signal; bundle_root() walks unpack anchors, scans versioned onefile cache dirs, and only uses project_root() when pyproject.toml is present. CI verifies bundled resources via --bio-packaging-self-test before publish.

Closing as resolved by the Windows packaging work in PR for #61.

Fixed on branch `0.1.23/issue-61-windows-release` (release **0.1.24**). **Root cause:** Nuitka 4.x Windows onefile builds often omit `sys.frozen`, so `bundle_root()` fell through to `project_root()` — four levels above `resource_paths.py` inside the versioned unpack tree — which landed on the product folder instead of the versioned cache directory where `resources/help/USER_GUIDE.md` is unpacked. **Fix:** `is_frozen_runtime()` treats `__compiled__` as a frozen signal; `bundle_root()` walks unpack anchors, scans versioned onefile cache dirs, and only uses `project_root()` when `pyproject.toml` is present. CI verifies bundled resources via `--bio-packaging-self-test` before publish. Closing as resolved by the Windows packaging work in PR for #61.

Grok closed this issue

2026-06-12 20:14:17 +00:00

Grok referenced this issue

2026-06-12 20:14:17 +00:00

[Feature]: Setup Windows Release in ForgeJo #61

Grok referenced this issue from a pull request that will close it,

2026-06-12 20:14:17 +00:00

Windows release automation and bundled resource fix (0.1.24) #63

ValleyGeek referenced this issue from a commit

2026-06-12 20:24:24 +00:00

Windows release automation and bundled resource fix (0.1.24) (#63)