A Store package shows a different icon in its row and on its page

Open Beginner friendly
#818 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
82/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
macos, swift
Domain
frontend

Research direction

Read Sources/StableBar/PackagesView.swift around lines 362–365 and Sources/StableBar/PackageDetailView.swift around lines 102 and 442. Compare how package rows render widget symbols and theme previews with the detail header's PackageIcon; then update the header to match the row and remove PackageIcon if unused. Done when widget headers use the index symbol or shippingbox fallback, and theme headers show the theme preview.

Written by the indexing model from the issue text.

Description

enhancement

Problem

In Settings → Store, a widget package's row shows the SF Symbol the Store index gives it: the symbol in stablebar-packages' listing.json, such as a gauge for Status ring. Open the package and its page shows a different icon: a white letter on a color hashed from the package ID, such as a green S. A theme's row shows a small preview of the theme, and its page the same kind of letter tile.

So a package changes its look once you open it, and the tile's color means nothing. The Store now has three pictures for one package: the row's symbol, the page's letter and the page's screenshot.

Proposal

The page's header shows what the package's row shows:

  • A widget package: the index's symbol in the row's tile, or shippingbox when no source gives one (a local folder, a private source without symbols).
  • A theme: the row's small preview.

PackageIcon then has no other use and can go.

Possible today

No. The row draws RowIcon(symbol: entry.symbol ?? "shippingbox") (Sources/StableBar/PackagesView.swift:365), and themes PackageListPreview (:362). The page's header draws PackageIcon(id:name:) (Sources/StableBar/PackageDetailView.swift:102, defined at :442), which ignores symbol. Checked on origin/main at da7455a.

Related

  • #711 added category and symbol to the index and the rows' icons, and kept the page's letter tile.
  • #144 / #152 put previews in the package list. #711 replaced them with symbols for widget packages and kept them for themes.

Triaged by Claude Code (Claude Opus 5.5).

Dominant language
Swift
Stars
184
Forks
12
Avg merge
3h 50m
Merged PRs (30d)
387

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Seb-GRAF/StableBar

All issues in Seb-GRAF/StableBar

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.