Widget: explain how to set the username when it shows "Set a GitHub username"

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

Nobody has claimed this yet.

Assessment

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

Research direction

Start with the empty-widget string in ContributionsWidget/Localizable.xcstrings and inspect the existing translations. Check the widget layouts at small, medium, and large sizes, then verify the Settings > Widget Setup guidance and images referenced by #37. Done means every shipped language explains how to set the username and the text is not truncated at any widget size.

Written by the indexing model from the issue text.

Description

enhancement

Context

The widget's username is set separately from the users added in the app. A new widget only says "Set a GitHub username" (ContributionsWidget/Localizable.xcstrings). It doesn't say how to set it, so people think the widget is broken. This keeps happening:

  • 2026-10-19, App Store review (UAE, 4★): "it displays the progress only inside the app, not in the widget. It keeps telling me to set a GitHub user." (iPhone 15 Pro Max, iOS 27.0.1. ASC review data doesn't include the app version.)
  • 2025-06-14, App Store review (Russia, 5★): asks to choose a user already added in the app.
  • #26 (2024-10): same confusion. Closed after Ander explained the "Edit Widget" steps.

#31 is the long-term fix (pick a user from the app inside the widget's configuration). This Issue is the small, quick fix for the empty widget.

Goal

Someone who adds the widget without configuring it knows how to set the username.

Checklist

  • Change the empty-widget text to say how to set it, for example "Touch and hold, then Edit Widget to set your GitHub username". Wording is up to Ander.
  • Update every existing localisation of the string.
  • Make sure the text fits the small, medium and large widget sizes.
  • Check that Settings > Widget Setup still matches, and that its images load (see #37).

Done when

A new, unconfigured widget explains how to set the username, in every shipped language, without text truncation at any size.

Source: Late Lunch support triage 2026-11-18 (App Store Connect customer reviews).

Dominant language
Swift
Stars
401
Forks
39
Avg merge
9m
Merged PRs (30d)
9

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 latelunchapps/github-contributions-ios

All issues in latelunchapps/github-contributions-ios

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.