gosentry/docs/PERFORMANCE.md

Performance Notes

Measured performance findings for GoSentry. Each entry records the method so the numbers can be reproduced and re-checked after relevant changes.

Startup Time

Finding (2026-06-22)

After the Phase 4 refactor, cold startup time (the History "Window shown in …" metric) increased by ~290 ms. The increase is caused entirely by the Fyne v2.5.3 → v2.6.3 upgrade (task T4.1), not by the Service / domain / UI restructuring.

Method

Env-gated phase timers (GOSENTRY_TIMING) were added across the startup path (Run in src/ui/run.go and newMainView in src/ui/mainwindow.go) and the equivalent points in the pre-refactor entry point (src/gui/app.go at commit c5e0ef9, the last commit before T4.1). Both were built with the CGO / MSYS2 UCRT64 toolchain and run 5× each; the first run of each is a cold-disk outlier and is excluded. The timed span (started → w.Show()) is identical in both builds, so the comparison is fair.

Results (warm-run averages)

Phase (cumulative from start)	Old (Fyne 2.5.3)	New (Fyne 2.6.3)	Δ
after single-instance check	~0.5 ms	~0.6 ms	—
after Fyne app + window + tray	~277 ms	~285 ms	+8 ms
app.Open() done	+3 ms	+3 ms	0
views built + svc.Start()	+42 ms	+43 ms	~0
after SetContent	~348 ms	~353 ms	+5 ms
after w.Show() (TOTAL)	~348 ms	~644 ms	+~290 ms

Interpretation

• Everything up to and including SetContent costs the same in both versions (~350 ms). The refactor-specific code — app.Open() (~3 ms) and the new app.Service plus view construction (~42 ms) — is unchanged, so the restructuring added no measurable startup cost.
• The entire regression lands in w.Show(): ~0 ms under Fyne 2.5.3, ~290 ms under 2.6.3. Fyne 2.6 reworked main-thread marshaling (the change that introduced fyne.Do) and front-loads first-window GL/driver realization into the Show() call.
• The cost is a fixed, one-time Fyne expense, not a leak in GoSentry code, and the upgrade cannot be reverted because fyne.Do requires Fyne ≥ 2.6.
• The tray / autostart path (--start-in-tray) skips w.Show() until the user opens the window, so it is unaffected.

Finding (2026-06-23, Fyne 2.7.4)

Fyne upgraded from v2.6.3 → v2.7.4 as part of Phase 6 (P6.1). Measured using the same method as the 2026-06-22 baseline: the History tab "Window shown in …" event, which records the span from application entry to w.Show() completion.

Warm-run average: ~400 ms (down from ~644 ms on Fyne 2.6.3).

Interpretation

Fyne 2.7 recovered roughly ~240 ms (~37%) of the w.Show() regression that arrived with the 2.6 threading model change. Fyne 2.7.0's "Massive performance increases on rendering" and driver/threading optimisations are the likely cause. The upgrade is a net win: the fyne.Do threading API (required since 2.6) is retained, and the primary startup cost is substantially reduced.