Polish setup's wording and small visual details

Abierto
#467 0 comentarios 0 reacciones 0 asignados Ver en GitHub

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
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
macos, swift
Área
design, desktop

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

enhancement P3

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.
Closing card: Edit Bar in Place wraps onto two lines

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

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Seb-GRAF/StableBar

Todos los issues de Seb-GRAF/StableBar

Issues similares

Más issues de Swift

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.