Skip to content

feat(ui): UI fixes - #5

Merged
dianjixz merged 19 commits into
CardputerZero:mainfrom
d4rkmen:feature/ui-fixes
Oct 23, 2026
Merged

dianjixz merged 19 commits into
CardputerZero:mainfrom
d4rkmen:feature/ui-fixes

Conversation

@d4rkmen

@d4rkmen d4rkmen commented Oct 16, 2026

Copy link
Copy Markdown

What changed

  • Long names bounce like the APPLaunch title: hold 2 s, scroll at 40 px/s, hold, and scroll back, keeping the reading position across redraws.
  • App selection screen: the icon sits on the right at the full height between the header and the shortcut tabs; the name, color-coded version/maintainer/size/date tags, and permission icons sit on the left in fixed rows. The header shows raised arrow buttons with the category position, the selected app's position, and the catalog size.
  • Permissions: the backend emits the registry permissions object as a bit set in a new trailing summary field. Summaries without it read as no permissions.
  • Details screen: the same color-coded fields, a readable description, and a short glide when scrolling.
  • Shortcut hints hang from the bottom edge as bookmark tabs.
  • Key sounds: Store starts the audio service and plays the launcher's system sounds, the switch sound for navigation and the enter sound for actions. This adds miniaudio to the binary (about 1.8 MB).
  • Held keys: up and down on the details screen move the drawn page instead of rebuilding it, and repeats wait until the last key's change is on screen.
  • Startup screen: the Store icon, one title per step, a thin progress bar with the registry host, and a single Tab hint. Registry failures show a compact alert with Exit and Settings.

Why

The 320×170 Store screens repeated labels, truncated metadata, and froze while a key was held: each repeat rebuilt the page, which takes longer than the 50 ms repeat interval, so queued keys kept the display from redrawing until release. Store keys were also silent while the launcher clicks.

Validation

  • tests/run_tests.sh passes on macOS (native backend runtime tests are skipped there). Tests were added or updated for the marquee, detail scrolling, key sounds, permissions, and the startup view model.
  • Linux AArch64 framebuffer build deployed to a CardputerZero: checked the selection and details screens, held-key scrolling (each repeat now handled in about 1 ms, down from 26–51 ms), key sounds, and the startup screen states.
  • The startup failure alert was checked in an off-screen render only. The SDL desktop config also enables CONFIG_CP0_LVGL_INIT_AUDIO but was not built here.

d4rkmen added 9 commits October 16, 2026 15:36
The Settings screen now follows the startup screen's dark Apple look, with a
segmented region control and the registry picker bracketed by chevrons. The
add/edit screen scrolls its fields to a caret that Fn+Z/C moves, steps Enter
through Name and URL before enabling Save, and reports why a save was
rejected. The editor also plays key sounds, and held keys keep clicking while
their redraw waits.
@d4rkmen

d4rkmen commented Oct 18, 2026

Copy link
Copy Markdown
Author
trim.1FC67C61-4064-4945-B3B1-D3344AB2447C.MOV

@d4rkmen

d4rkmen commented Oct 18, 2026

Copy link
Copy Markdown
Author
trim.FFDC9389-6EA8-4FEE-B70E-6C6C672C3B69.MOV

@d4rkmen

d4rkmen commented Oct 18, 2026

Copy link
Copy Markdown
Author
trim.E421F000-6575-4DCE-9854-336687230A4A.MOV

@Harrison-Xu

Copy link
Copy Markdown

Thanks for your contributions! These changes could make the Store UI look more modern and user-friendly, and we really appreciate the effort you've put into this PR.

We've reviewed the proposed changes and have some thoughts on which ones we'd like to adopt and which we'd prefer to approach differently. There are also a few additional improvements we've been planning that we'd love to hear your thoughts on.

Here are our thoughts on each change:

Changes we'd like to accept

  1. Long name scrolling: The back-and-forth scrolling looks great! We've already merged your similar contribution to Launcher, so we'd be happy to bring the same behavior to Store.

  2. Key sounds: Great addition! Reusing the launcher's system sounds is a good approach. We've also been using UISFX (GitHub) in several parts of the system, so perhaps we could use some of its sounds in Store as well.

  3. Startup screen: The new design looks really nice. Thanks for the improvement! We'd love to accept this.

  4. App details screen: The redesigned details page looks good, and we'd be happy to accept it. We especially appreciate the smoother scrolling and the performance improvements for held keys. Fixing the screen freezes caused by repeated key events is definitely valuable.

Changes we'd like to adjust

  1. App permissions: Thanks for adding this missing information! We'd like to show permissions on the individual app details page, but not on the main app list. Icons are a good approach. We'll look for seven more suitable icons later and add their explanations to a Fn + H help popup, which hasn't been implemented yet.

  2. Settings screen: The visual improvements look good, but we don't plan to support custom third-party registries, so the registry management and editing features won't be needed. The two existing registries have identical content and are hosted on different servers, mainly to help users in China who may have trouble accessing GitHub. We only need three options:

    • Auto: Automatically selects a server based on network connectivity.
    • Default: GitHub.
    • CN: Alibaba Cloud OSS.

Changes we'd prefer to leave as they are

  1. Main app list: The redesigned layout does look nice, but we think the current visual design works well enough too. We'd prefer to keep the existing layout for now.

  2. Bottom shortcut hints: We prefer the existing plain-text labels for the five number-key shortcuts. The bookmark-style tabs aren't really necessary, and we'd like to save as much screen space as possible on this small display.

Additional improvements we'd appreciate

There are also a few improvements we've been planning for Store. If you're interested, we'd really appreciate your help with these as well:

  1. Update directly from the app list: Currently, available updates are only indicated on the app details page. We'd like users to be able to see when an app has an update available directly from the main app list, and update it without opening the details page. For apps with an available update, the reinstall shortcut could be replaced with update.

  2. Simplify app categories: We'd like to remove the RECOMMENDED category from the main app list, keeping only ALL, INSTALLED, and the predefined app categories.

  3. Larger screenshots on the app details page: The current screenshot previews are too small. We're planning to enlarge them to nearly the full screen width, with one screenshot per row, arranged vertically below the app description. This would make screenshots much easier to view directly on the details page.


Thanks again for all your work! We also appreciate the thorough testing you've done on the actual device!

We hope these suggestions help clarify our design direction, and we'd be happy to discuss any of the details further. Looking forward to seeing these improvements come together!

@d4rkmen

d4rkmen commented Oct 22, 2026 •

Copy link
Copy Markdown
Author

Thanks — this is very helpful. I’ll keep the long-name scrolling, key sounds, startup screen and details redesign; move the permission icons to the details page only; reduce Settings to Auto / Default / CN and drop registry management; revert the main-list layout and the bookmark tabs.

Regarding the main screen (app list) if you'd like to keep origonal design, consider atleast to align category label to chevrones / header labels. and to replace header text labels with icons for better expirience.
The version, name, size, date fields better to highlight with colors (at least font) because they look like a single text area and they are (almost) the same color as name label (this is confusing)

compare-main

@d4rkmen

d4rkmen commented Oct 22, 2026 •

Copy link
Copy Markdown
Author

Update feedback

Review items

1. Long name scrolling — kept.
Bounce timing and reading-position continuity are unchanged.

2. Key sounds — kept.
Launcher system sounds still play for navigation and actions; held-key playback remains tied to redraws.

3. Startup screen — kept.
Store icon, per-step title, progress bar with registry host, single Tab hint, and the failure alert are unchanged.

4. Details screen — kept.
Redesign, smoother scrolling, and the held-key performance fix are unchanged. The install-state dot is now vertically centred on its label.

5. App permissions — details only.
Icons no longer appear in the list. They are shown on the details page under a PERMISSIONS caption, in the same style and column as PACKAGE and CATEGORY. Badge height follows the caption’s line height. The backend permissions summary field and backward compatibility are retained.
Ready for the additional icon/help work when you are.

6. Settings — Auto / Default / CN only.
Custom registry selection, add/edit/delete, and the editor are removed, along with their backend commands. Auto now selects by actual catalog reachability (GitHub first, OSS fallback, bounded and cancellable), not by IP country; Default and CN stay pinned. Cached data never counts as reachable. Saved legacy configurations are normalised to one built-in source, and the mode plus effective server are persisted after sync.

7. Main list — restored.
The original layout is back: left icon with up/down arrows, right-hand name/metadata, plain counters, no bookmark tabs or colour chips. Long-name bounce is preserved.

8. Shortcut hints — restored.
Plain coloured text labels, original positions; no bookmark backgrounds.

9. Update from the list — added.
An installed app with a newer version shows UPDATE AVAILABLE below its size/date row, and shortcut 7 changes from reinstall to update, opening the existing upgrade confirmation directly from the list. Cancelling returns to the list; the details hint now also says update for consistency.

home  detail

10. Categories — simplified.
RECOMMENDED is removed from the backend and the catalog filtering. ALL, INSTALLED (still hidden when empty), and the registry’s categories remain.

11. Screenshots — enlarged.
Screenshots now follow the description as vertical rows, one per row at 300 px wide with aspect ratio preserved. Missing or corrupt images show a short placeholder without breaking the layout. The full-screen viewer remains on 5 and still cycles with Z/C.

Extra changes (not in the review list)

  • Extended keyboard control on the details page: Z/C and L/M page up/down, K/N jump to the start/end, while F/X keep the line-by-line scroll.
  • Removal returns to the list: a successful uninstall now goes back to Home instead of leaving an uninstalled app open in details.
  • Screens key hint added for 5 on Details screen

@Harrison-Xu

Copy link
Copy Markdown

Great thanks!

About the version, name, size, date fields on apps list page, I agree with you: the four text fields should be in different colors.

@dianjixz
dianjixz merged commit 64356fc into CardputerZero:main Oct 23, 2026
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.

3 participants