User journey: Alex discovers and listens to music on Rymflux
From first launch to regular daily listening. Covers Alex's end-to-end experience.
User journey: Alex discovers and listens to music on Rymflux
Metadata
- Persona: Alex — the multi-format listener
- Scenario: Install Rymflux, configure local music, search and play across sources
- Stage: Adoption → Retention
- Frequency: Daily
Journey stages
| # | Stage | User action | Touchpoint | Emotion | Docs touch |
|---|---|---|---|---|---|
| 1 | Discover and install | Alex hears about Rymflux on Reddit, visits the website, downloads the desktop app | Website, OS download | 🟡 Curious but cautious — will it work with their setup? | Getting-started guide |
| 2 | First launch | Alex opens the app. Sees a clean Home screen with no content and a “Getting Started” prompt | App Home | 🟡 Empty state is clean but they need direction | First-run experience, plugin setup guide |
| 3 | Configure local files | Alex clicks “Add Music Folder,” browses to their FLAC directory, confirms | App settings / local-files plugin config | 🟢 Easy — one dialog, one click | Quickstart guide |
| 4 | Browse music | Alex opens the Music Room. Albums appear organized by artist with cover art | Music Room browse view | 🟢 Immediate gratification — content appears without indexing delay | Music Room feature doc |
| 5 | Play a track | Alex clicks an album, selects a track, presses play. Audio starts within 1 second (local file) | Music Room player | 🟢 Fast, works as expected | — |
| 6 | Search across sources | Alex types “Imagine Dragons” in the search bar. Results appear from local files (and the Spotify plugin if installed) | Music Room search | 🟢 Results are unified, deduplicated, fast | Search docs |
| 7 | Build a queue | Alex adds tracks from search results to the queue. Reorders them. Removes one. | Queue panel | 🟢 Intuitive drag-and-drop | Queue docs |
| 8 | Save to library | Alex favorites a track. It appears in the library under “Favorites.” Later, Alex creates a playlist and adds tracks from different sources | Library | 🟢 Works regardless of source | Library docs |
| 9 | Switch rooms | Alex is listening to music, opens the room selector, and briefly checks another room. Music continues playing | Room navigation | 🟢 Seamless — playback uninterrupted | Room framework docs |
| 10 | Daily return | Alex opens the app. Home shows “Continue Listening” with the last track, “Recently Played,” and pinned rooms | Home | 🟢 Personalized, no friction | — |
Pain points
- Stage 2 (First launch): If there is no “Getting Started” guidance or the empty state is confusing, Alex may close the app and never return. Mitigation: Home shows clear next steps (plugin setup link, add music folder).
- Stage 3 (Configure local files): If the plugins directory is not clearly documented or the local-files plugin is not pre-installed, Alex may not find it. Mitigation: reference plugin ships with the app.
- Stage 6 (Search across sources): If no Spotify plugin exists yet, Alex can only search local files. Disappointing if they expected streaming. Mitigation: Home and Music Room show available plugins and hint at how to add more.
- Stage 9 (Room switching): Only one room exists in v1 (Music). Switching to other rooms is not possible. Mitigation: Home + Music are the only destinations in v1. Avoid showing empty room slots.
Opportunities
| Stage | Opportunity | Doc type needed | Priority |
|---|---|---|---|
| 1 | Provide a clear download page with system requirements | Getting-started | H |
| 2 | First-run experience with a “Quickstart” overlay or inline guidance | Tutorial | H |
| 3 | One-click “Add Music Folder” with clear path selection dialog | Feature doc | H |
| 6 | Document which plugins are available and how to install them | Plugin discovery guide | M |
| 8 | Library docs explaining unified content model (source-independent) | Feature doc | M |
| 10 | Ensure Home is useful even with one room and one plugin | Feature doc | L |
Success criteria
- Alex can install, configure local music, and play a track within 5 minutes of first launch (NFR-PERF)
- Alex can search across all content sources with one query (FR-CORE-4)
- Alex can build a queue from multiple sources and play through it (FR-CORE-2)
- Saved content in the library is source-independent (FR-CORE-3, FR-ID-1)
- Room switching maintains queue and playback (FR-ROOM-1 — single room in v1, verified in v2)
Related
- Persona: Alex — the multi-format listener
- User stories: Play music, Search across sources, Save to library
- Feature docs: Music Room, Home (Lobby), Library