Edit a widget's popup in Settings, not only in JSON

Open
#217 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
54/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
swift
Domain
desktop

Research direction

Start with Sources/StableBar/WidgetSettings.swift and the layout block documentation in docs/create-a-widget.md; inspect how Settings currently edits widget properties and how popups are represented. Build the proposed popup block tree editor with add, remove, reorder, and block editing controls plus a live preview. It is done when a widget’s popup can be edited in Settings without JSON and the preview reflects those edits.

Written by the indexing model from the issue text.

Description

enhancement P3

Problem

Settings edits a widget's content, style and behaviour, but not its popup. These need JSON, through Edit as JSON… or the command line:

  • A popup's contents (its layout blocks) and hoverLayout (docs/create-a-widget.md).
  • Click commands and menus: for a widget with them, Settings says "This widget runs a command and opens a popup. Change it with Edit as JSON in the More menu." (WidgetSettings.swift:27, :51).
  • openOnHover for shared popups under popups (docs/popups.md). Inline popups have Open its popup on hover in Settings.

Proposal

A first step: in Settings, a widget with a popup gets an editor for the popup's block tree (add, remove, reorder and set blocks) with a live preview.

Stays JSON-only for now: click commands, menus, hoverLayout, shared popups and their openOnHover.

Possible today

Yes, by editing JSON through Edit as JSON…, the command line or the configuration file (docs/popups.md).

Related

  • #103 moved widget setup out of JSON, except popups and click commands.
  • #88 added openOnHover and its toggle for inline popups.
  • #16 draws widgets and popups through layout blocks.

Checked on main 4160f7f.

Triaged by Claude Code via T3 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.