Polish setup's wording and small visual details
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 48/100
Línea de trabajo
Start with the referenced setup files: Sources/StableBar/SetupPreferences.swift, SetupTour.swift, SetupDemo.swift, SetupWindow.swift, and BarView.swift. Review the setup flow and its wording, progress dots, preset icons, closing card, menu-bar guidance, and contrast, then check the related step ordering in issue #450. Done when the proposed details are addressed consistently across setup and the bar's right-click menu.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
Small details from a UX review of setup. Each is minor; together they make setup harder to read.
- "Keep current" means nothing on a first run. That covers Keep current for Appearance and Clock, and the theme's Current badge. On a new configuration, Keep current is the same as Automatic and as 24-hour (
Sources/StableBar/SetupPreferences.swift:4-14). - Six progress dots for five steps. The dots don't match "1 / 5" because the first dot stands for the intro (
Sources/StableBar/SetupTour.swift:886-895). - Placement goes by three names: Replace / Keep the menu bar, Top edge / Below menu bar, and Keep the menu bar instead.
- "Click any of them." reads as an instruction (
Sources/StableBar/SetupDemo.swift:20), but the demo bar can't be clicked. - The preset tiles' widget icons are 8.5 pt (
SetupTour.swift:490), too small to tell apart. - The closing card.
- Edit Bar in Place wraps onto two lines next to Open Settings.
- "Undo restores the previous step" describes the bar editor, not setup (
Sources/StableBar/SetupWindow.swift:415).
- Hints point to a hidden icon. Step 5's Use the menu-bar icon and the card's "Reopen this guide with Getting Started… in the menu-bar icon's menu." point to an icon that sits in the hidden macOS menu bar once StableBar has replaced it. The bar's own right-click menu has no Getting Started… (
Sources/StableBar/BarView.swift:164-180). - Grey text loses contrast (white at 45–60%) when the drifting background turns bright behind it, for example around step 1's permission card.
Proposal
- Use plain first-run wording (Automatic, the system's clock format), and keep Keep current for reopened setups.
- Make the dots match the step count.
- Pick one pair of names for placement.
- Narrate the demo ("We click the clock…"), or make it interactive.
- Enlarge the preset icons.
- Fit Edit Bar in Place on one line and use setup's own words on the card.
- Add Getting Started… to the bar's right-click menu.
- Darken the area behind the text.
Related
- #450: reorders setup's steps.
Triaged by Claude Code (Claude Opus 5.5).
- Lenguaje dominante
- Swift
- Estrellas
- 184
- Forks
- 12
- Merge medio
- 3 h 50 min
- PR fusionados (30 d)
- 387
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de Seb-GRAF/StableBar
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 52/100
Los mantenedores suelen responder en 1 día
-
Menu bar items drawn as in the menu bar show the wrong part of the menu bar after a display changePosiblemente ocupada @Jonathanm10 la tomó hoy. Abiertoneeds-triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 35/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
Los mantenedores suelen responder en 1 día
-
Allow the App Menu to display the frontmost app iconPosiblemente ocupada @khatami10 la tomó hoy. Abiertoenhancement needs-triage
Dificultad 3/5 1-2 días Aptitud para principiantes 35/100
Los mantenedores suelen responder en 1 día
Todos los issues de Seb-GRAF/StableBar
Issues similares
-
good first issue help wanted testing
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
-
area:cli documentation good first issue priority:low
Dificultad 1/5 Menos de una hora Aptitud para principiantes 94/100
isaaclins/freesnitch#430 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
MasterJ93/ATProtoKit#354 ·
-
enhancement help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
heysidhant/appvanish#4 ·
-
bug priority:low status:queued
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día