Skip to content

(CODUX-119) Document desktop system bar behavior - #2700

Merged
numnx merged 1 commit into
feature/CODUX-187-fix-system-barfrom
task/feature-codux-187-fix-system-bar-t03-codex-mrc3mzx3
Jul 8, 2026
Merged

(CODUX-119) Document desktop system bar behavior#2700
numnx merged 1 commit into
feature/CODUX-187-fix-system-barfrom
task/feature-codux-187-fix-system-bar-t03-codex-mrc3mzx3

Conversation

@numnx

@numnx numnx commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

🧩 Task: Document desktop system bar behavior

Automated task PR opened by Code UX for T03.

📋 Summary

Sprint: Sprint 187 · Fix System Bar · Task: T03

Restore the Electron desktop system bar so it is visible in the app, shows the Code UX version, exposes an update action, and reliably supports maximize/restore by double-clicking the bar.

🤖 Model & Provider

Provider Codex CLI
Model gpt-5.5

⏱️ Timing

Started 2026-07-08 13:14:00 UTC
Finished 2026-07-08 13:16:53 UTC
Duration 2m 53s

📊 Token Usage

Metric Value
Input tokens 62,426
Cached input tokens 647,424
Output tokens 6,106
Total tokens 715,956
Invocations 1
Tool calls 31
Active time 2m 33s

Included usage estimate (subscription/local login): $0.82

✅ QA Review

⏳ QA review runs after this PR is opened. Check the task card in the dashboard for the outcome once it lands.

📝 Full Task Prompt
## Objective
Document the restored Electron desktop system bar behavior so future changes preserve the visible version label, update action, and double-click maximize/restore contract.

## Scope
- Edit `docs/deployment/electron-desktop.md`
- Edit `docs/dashboard/design-system-shell-navigation.md`
- Edit `docs-web/user/installation.md`
- Existing docs links in `docs/index.md` and `docs/SUMMARY.md` already include the Electron desktop page, so only verify them unless a new page is created
- Documents behavior implemented by T01 and T02

## Implementation Requirements
1. Add a concise section to `docs/deployment/electron-desktop.md` describing the frameless desktop system bar, version label from `package.json`/`__APP_VERSION__`, update button behavior, preload IPC boundary, and double-click maximize/restore behavior.
2. Extend `docs/dashboard/design-system-shell-navigation.md` with system-bar design constraints: compact `h-9` chrome, no-drag interactive controls, accessible labels, and stable behavior across macOS traffic lights and Windows/Linux custom controls.
3. Update `docs-web/user/installation.md` under Updating or Desktop app notes to explain that the desktop title bar update button opens the latest GitHub Releases page and does not perform an in-app automatic update.
4. Verify `docs/index.md` and `docs/SUMMARY.md` still link to `docs/deployment/electron-desktop.md`; only edit those files if the documentation structure changes.

## Constraints
- Do not claim Code UX has automatic background updates unless code implementing that exists.
- Keep docs user-facing where appropriate and avoid raw implementation-only wording in `docs-web/user/installation.md`.
- Preserve existing release artifact and installer guidance.
- Do not add a new docs page unless the existing Electron page cannot house the behavior cleanly.

## Verification
- Run `pnpm run lint`.
- Manually verify the updated docs mention version display, update button behavior, and double-click maximize/restore exactly once in the relevant desktop sections.
- Success means docs match the implemented behavior and no TypeScript/lint errors are introduced.
🌿 Branch Info

Base: feature/CODUX-187-fix-system-bar
Head: task/feature-codux-187-fix-system-bar-t03-codex-mrc3mzx3


🤖 Generated by Code UX

@numnx
numnx merged commit c5c14e3 into feature/CODUX-187-fix-system-bar Jul 8, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant