wordpress-mobile / wordpress-mobile/WordPress-Android
Quick Start Tour Tweaks
Open
Nobody has claimed this yet.
[Type] Enhancement
/My site
My Site Dashboard
Quick Start
- Dominant language
- Kotlin
- Stars
- 3.2k
- Forks
- 1.4k
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 69
Description
Context
- In the My Site Dashboard project we have converted the existing Quick Start entry point into a dashboard card.
- As we are moving other pieces to the new My Site Fragment/Screen, we noticed some of the tour guide text was not using the native Snackbar component.
- We've moved the custom tour steps to the native Snackbar components.
- There are some gaps and discrepancies which we want to tidy up.
Issues Found
Text Styes:
- In the one line Snackbars, normal text is regular weight, grey color. Emphasised text is regular weight, white colour. This is fine. Can stay.
- In the prompts which we have changed. Most text is regular weight, grey color. Emphasised text is bold weight, grey color. Can we change the emphasised text to bold weight, white color. This should match the emphasis we had before the change.
- If having emphasis change both colour and font-weight is not possible in the component, we can look at a different solution.
Dead pixels above Snackbar
- Above some of the Snackbars there is an area where the UI is cut-off/hidden
- It might be to do with the way the shadow or padding around the Snackbar is rendered
- I have seen this issue before so it might be pre-existing
- See image below, the 'Stats' list item is being partly cut-off

Area hidden after Snackbar dismisses
- After the Snackbar has been dismissed, I noticed a couple of times the visual area where it had been is still hidden
- Might be related to the above issue

Delayed Snackbars
- On some of the steps in the tour, it told me to take an action
- When I tapped 'Go', it scrolled me to the relevant location and showed the blue dot with the touch target
- The Snackbar didn't display immediately. I could only see the blue dot. Sometimes the Snackbar appeared after I'd even tapped the dot, so it felt a bit glitchy.
- This happened on the steps for: View Site, Create post, Search Reader, Check Stats
Snackbars disappear quite quickly
- Sometimes the next prompt disappeared before I had read it
- Previously, did it auto-dismiss? I think you said it did, but maybe had a longer duration?
- I would err on the side of longer duration
End of tour
- When the tour ends, there's a notification in the notifications tab
- There's no success indication in the My Site UI. Was this the case before?
- The Quick Start card disappears immediately. Was this the same as before? I'd be tempted to show it completed after the last step, then dismiss it after 1 day or similar afterwards.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Quick Start tour and its native Snackbar components, reproducing the steps for View Site, Create post, Search Reader, and Check Stats. Compare the emphasis styling, clipping, dismissal, timing, and end-of-tour behavior against the reported screenshots; done means the listed tour prompts display consistently and the Quick Start flow completes without the reported glitches.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- android, kotlin
- Domain
- mobile
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100