beeware/toga

Revamp screenshots in Supported Platforms

Open

#4358 opened on Apr 30, 2026

View on GitHub
 (4 comments) (0 reactions) (0 assignees)Python (3,615 stars) (624 forks)batch import
documentationgood first issue

Description

What kind of documentation issue is this?

Incorrect documentation

Affected page

https://toga.beeware.org/en/latest/reference/platforms/

Describe the issue

At https://toga.beeware.org/en/latest/reference/platforms/, if you click on all the platforms, Qt is missing a screenshot for the demo app; Windows screenshot uses Win10 style; and macOS screenshot uses an extremely ancient style.

Suggested improvement

Update screenshots for all desktop platforms; mobile and web/textual doesn't have enough widgets or structures to run the demo app yet. Align the screenshots with the homepage screenshots as well.

Contributor guide

Tech stack
python
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
PythonToga demo appScreenshot tool
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90
Research direction
The issue requires updating screenshots for the supported platforms documentation page. First, run the Toga demo app on each desktop platform (Qt, Windows, macOS) to capture current screenshots. Ensure screenshots align with the homepage style. Update the respective image files in the documentation repo, likely in the 'reference/platforms' directory. Reference the existing issue comments for any specific guidance on style or required platforms.