Skip to content

[GUI][rc12 candidate][cosmetic] Simplify sidebar header and hide run path until Workspace is expanded #52

Description

@YaoxiangLi

Summary

The top of the GUI sidebar is still visually crowded in the Windows v0.2.0rc12 candidate. It permanently shows a large branding card, the tagline/version, the absolute run-directory path, a large Workspace expander, and the tutorial button before navigation begins.

This is cosmetic/UX feedback only: preserve all workspace behavior, but simplify the persistent header and disclose secondary information only when requested.

Candidate tested

  • Repository/PR candidate: PR Fix match-motifs logging and native desktop apps #49
  • Commit: dfd283e9a1d64f5728b310af6e0b2c373337de5a
  • Windows artifact workflow run: 32452692335
  • Artifact ID/name: 9436464405 / fp-tools-gui-windows-x64
  • Executable SHA-256: c8cfbd635a2835980f69fa45ed8cb03787ffa2069706a174b91e811a742c389d
  • GUI-reported version: v0.2.0rc12
  • Platform: Windows x64

Steps to reproduce

  1. Launch fp-tools-gui-windows-x64.exe.
  2. Open the GUI and inspect the top of the left sidebar.
  3. Use a run directory with a realistic long Windows path, for example C:\fp-tools-win-test\pr49\test-output\....

Actual result

The persistent sidebar header contains:

  1. A bordered branding card with fp-tools.
  2. Command-first footprinting workflows · v0.2.0rc12 underneath the name.
  3. A separate Run dir: <absolute path> line, which becomes truncated and visually noisy.
  4. A large Workspace expander immediately below it.
  5. A full-width Show guided tutorial button.

The tagline does not help routine navigation, the version is overly prominent, and the environment-specific absolute path competes with the actual navigation. The path is also duplicated conceptually because Workspace already exists to inspect/change it. Together these controls consume substantial vertical space before OVERVIEW begins.

Expected result / recommended layout

Keep the default collapsed state compact:

fp-tools

Workspace  >
Show guided tutorial   (secondary/compact treatment is sufficient)

OVERVIEW
...

Recommended behavior:

  • Keep only fp-tools in the persistent brand area.
  • Remove Command-first footprinting workflows from the persistent sidebar.
  • Do not show the complete Run dir: path above the collapsed Workspace control.
  • When Workspace is expanded, show the full current run directory and the existing edit/apply controls there.
  • Keep the application version accessible but unobtrusive—for example inside expanded Workspace, an About area, or a sidebar footer.
  • Preserve the full path (not only an ellipsis) when expanded so it can still be inspected/copied.
  • Reduce the branding container padding/height, or use a simple text heading rather than a large bordered card.

Relevant implementation

src/fp_tools/gui_app.py currently renders all persistent header content in _render_sidebar_header():

<div class="fp-sidebar-brand">
  <div class="fp-sidebar-brand-title">fp-tools</div>
  <div class="fp-sidebar-brand-subtitle">Command-first footprinting workflows · v...</div>
</div>
<span class="fp-run-dir-pill" ...>Run dir: ...</span>

The existing _render_sidebar_run_dir_controls() already provides the natural place for on-demand workspace details:

with st.sidebar.expander("Workspace", expanded=False):
    run_dir_input = st.text_input("GUI run dir", ...)

A focused implementation would therefore remove the subtitle/run-dir pill from _render_sidebar_header(), move the current-path display into that expander, and tighten .fp-sidebar-brand spacing.

Acceptance criteria

  • In the default collapsed sidebar, the persistent brand header shows only fp-tools.
  • Command-first footprinting workflows is not permanently displayed.
  • No absolute run-directory path is displayed until Workspace is expanded.
  • Expanding Workspace shows the full current run directory and still allows it to be changed/applied.
  • The app version remains discoverable in a secondary location.
  • OVERVIEW and the navigation begin noticeably higher than in the rc12 candidate.
  • Long Windows and POSIX paths do not overflow, overlap, or force horizontal scrolling when Workspace is expanded.
  • Layout is checked in the native Windows window and Chrome at common widths (including a narrow sidebar).
  • Workspace path semantics and all existing run behavior remain unchanged.

Scope

Cosmetic/sidebar information architecture only. This issue should not change how run directories are resolved, created, persisted, or used by workflows.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions