| lang | en |
|---|
- Clean State Home
- Allow Notifications
- Navigate to Credits
- Clean State Credits
- Change Exercises Database
- Navigate to Exercise List
- Clean State Exercise List
- Search Exercises in Browser
- Learn About an Exercise
- Add Custom Exercise
- Edit a Cloned Exercise
- Navigate to Analytics
- Clean State Analytics
- Navigate Back to Home
- Full Workout Session
- Cancel Empty Session
- Repeat Session from History
- Delete Past Sessions
- Lookup a Previously Done Exercise
- Be Astonished by Your Incredible Progress
Comprehensive user stories for LogOut that each corresponds to an independent, isolated feature, but some might need preconditions like pre-existing state (completed session, custom exercise…). Preconditions may be satisfied by executing other user stories or common sub flows before. No global ordering between them is assumed nor required, and they don’t care about the state left.
User stories serve as a basis for end-to-end test for each supported platform:
- Web browser PWA via Maestro in
maestro/web/ - Android native application via Maestro in
maestro/android/
But UI only tests run only on PWA to save time, while features interacting with external systems (notifications, database…) must be tested on both platforms.
As a user and a tester, I want to see the Home in an initial state when I first launch the app, so that I’m not disturbed by existing training Session(s) that shouldn’t.
- No sessions present: either the app has never been used, or all previous sessions have been deleted (see Delete Past Sessions)
- Header contains strings
- "💪 LogOut"
- "Turn off your computer, Log your workOut"
- Main body contains strings
- "No past sessions yet"
- "Tap + to start your first workout"
As a user, I want to allow notifications when prompted, so that I can receive exercise and rest duration reminders.
- Notification permission has not yet been granted or blocked in the browser
- A toast is present containing "
⚠️ Tap here to enable notifications" - When clicked, the notifications’ permission dialog opens
- When notifications are denied, a toast with "
⚠️ Notifications blocked" appears - When notifications are allowed in browser settings, the toast disappears
As a user, I want to navigate to the credits page, so that I can see information about the app and configure settings.
- Be on a page different than credits
- The bottom navigation bar contains a "ℹ️" button
- When clicked, it opens the Credits page
- Header displays "ℹ️ Credits"
- "ℹ️" button is slightly emphasized compared to others in bottom navigation bar
As a user and a tester, I want to see the Credits page in a clean, initial state when I first launch the app, so that I’m not disturbed by existing customization that shouldn’t be.
- The exercise database URL has not been changed from the default value
- The database URL input shows the default URL
(
https://raw.githubusercontent.com/gfauredev/free-exercise-db/main/)
As a user and a tester, I want to change the exercises database URL, so that I can use a custom database instead of the default one.
- Input the test exercise database address (
http://localhost:8080) - Click the save button, database URL is saved without errors
As a user, I want to navigate to the Exercise List, so that I can browse available exercises.
- Be on a page other than Exercise List
- The bottom navigation bar contains a "📚" button
- When clicked, it opens the Exercise List page
- Header displays "📚 Exercises"
- "📚" button is slightly emphasized compared to others in bottom navigation bar
As a user and a tester, I want to see the Exercise List in an initial state when I first launch the app, so that I’m not disturbed by existing custom Exercise(s) that shouldn’t.
- No custom exercises added yet (custom exercises cannot be deleted)
- There are only built-in exercises, no custom ones created by a user
- Built-in exercises show a "+" button (title: "Clone then edit"), not a "✏️" button
- A "✏️" button (Edit) is only shown on custom exercises
As a user, I want to search for exercises of the database via the Exercise List, so that I can quickly find a specific one.
- Exercise List page header displays a search input
- Typing a search term filters the exercise list
- Exercises matching the search filter are visible, others are hidden
- Multi-word queries are error-tolerant: each word is matched independently so that e.g. "wide grip bench" finds "Wide-Grip Barbell Bench Press"
- The page remains functional after searching
- Removing search term(s) shows the full exercise list again
As a user, I want to learn about an exercise details, so that I can perform it properly and confidently.
- Clicking on an Exercise heading displays the exercise’s instructions
- Clicking on an Exercise image cycles to the next image
- A row of tags displays Category, Force, Equipment, and Level of the exercise
- A row of tags displays Primary Muscle(s) targeted by the exercise
- A row of tags displays Secondary Muscle(s) targeted by the exercise
Not every exercise has every detail available, so try other exercise instead of failing the test in case something is missing
As a user, I want to add a custom exercise to the database, so that I can log exercises that are not in the built-in list.
- A "+" button is located near the search bar
- When clicked, it opens the Add Exercise form
- Filling in the exercise name and clicking save button creates a new exercise
- The new exercise is visible in the Exercise List
As a user, I want to edit a built-in exercise after cloning it, so that I can create a custom clone that fits my training better.
- A "+" button (titled "Clone then edit") is located on each built-in exercise
card
- When clicked, it clones the exercise and opens the Edit Exercise form
- Changing the exercise name and clicking save button creates a new exercise
- The modified clone is visible in the Exercise List with the new name
As a user, I want to navigate to the analytics page, so that I can view my workout progress over time.
- Be on a page different than analytics
- The bottom navigation bar contains a "📊" button
- When clicked, it opens the Analytics page
- Header displays "📊 Analytics"
- "📊" button is slightly emphasized compared to others in bottom navigation bar
As a user and a tester, I want to see the Analytics page in an initial state when I first launch the app, so that I’m not disturbed by existing training data that shouldn’t.
- No completed sessions present: either the app has never been used, or all sessions have been deleted (see Delete Past Sessions)
- Select any metric in "Weight", "Repetitions", "Distance", "Duration"
- Then, no exercise can be selected, as none has been done yet
As a user, I want to navigate back to the home page, so that I can return to my workout session (history).
- Be on a page different than home
- The bottom navigation bar contains a "💪" button
- When clicked, it opens the Home page
- Header displays "💪 LogOut"
- "💪" button is slightly emphasized compared to others in bottom navigation bar
As a user, I want to start a new workout session, so that I can begin logging my exercises.
- The Home page contains a "+" button
- When clicked, opens the Active Session view
- Active Session
- Header displays "⏱️ Active Session", an elapsed timer, and a session button
- When the session is empty, the button shows "❌" (Cancel Session)
- After 1 second, the timer has incremented by 1 second
As a user, I want to search for an exercise in my active session, so that I can log it.
- Input an exercise name, category, or muscle in the search bar (multi-word search is supported, e.g. "wide grip bench" finds "Wide-Grip Barbell Bench Press")
- Select an exercise from the search results to open the exercise form
As a user, I want to record a completed exercise in my active session, so that I can track my progress.
- Input a random number between 0 and 99 inclusive in the first metric
- If there’s a second metric, tap a dozen times its "+" button
- Click on the "✓ Complete Exercise" button
- Completed exercise appears in the "Completed Exercises" section, with metrics
As a user, I want to replay a completed exercise in my active session, so that I can quickly perform another set.
- Click on the 🔁 button to replay the exercise (do another set)
- Slightly increment some non-null metric(s)
- Click on the "✓ Complete Exercise" button
- Second set appears in the "Completed Exercises" section, with higher metrics
As a user, I want to repeat the previous steps for another exercise, so that I’m able to record a varied session.
- Repeat the 3 previous steps in order to do sets of another different exercise
- Same acceptance criteria applies at each step
As a user, I want to remove a completed exercise from my active session, so that I can correct mistakes or remove unwanted entries.
- Click the 🗑️ button on the latest exercise to remove it
- There’s only 3 completed exercises left in the Active Session
As a user, I want to finish my active session, so that I can save it in my history and see my progress over time.
- Tap the "💾" (Finish Session) button in the active session header
- The home screen shows the completed session with the current date
- A congratulation toast appears
As a user, I want to cancel an empty workout session, so that I can return to the home screen without saving a useless, empty session.
- An empty active session has been started (no exercises recorded yet)
- The E2E test starts a fresh session itself, so no external setup is needed
- Active Session
- "Cancel Session" button is visible if the Session is empty
- Tapping "Cancel Session" returns to the Home view
- Home
- Heading "💪 LogOut" is visible again
- Main body still shows "No past sessions yet"
As a user, I want to start a new session based on a past workout, so that I can quickly repeat the same exercises.
- At least one completed workout session with at least one exercise exists; the E2E test creates this session itself using a setup subflow
- A completed session with at least one exercise is visible on the home screen
- Click 🔁 button on a previous Session card, a new Active Session opens
- The "Pre-added Exercises" section contains the previous session exercises
As a user, I want to delete a completed session from my history, so that I can remove unwanted or accidental entries.
- At least one completed workout session with at least one exercise exists; the E2E test creates this session itself using a setup subflow
- Click 🗑️ button on a Session card, a confirmation dialog opens
- Clicking "🗑️ Delete" in the dialog removes the session from the home screen
- After all sessions are deleted, the main body shows "No past sessions yet"
As a user, I want to look up exercises I have previously done, so that I can find similar exercises.
- At least one completed workout session with at least one exercise exists; the E2E test creates this session itself using a setup subflow
- The Session card contains done exercise(s) tags
- Click one of the tags, the Exercise List opens
- Exercise List
- The search bar is pre-filled with the name of the selected exercise
As a user, I want to see my workout progress over time in the analytics page, so that I can be astonished by my incredible progress and stay motivated to continue improving further.
- At least two sets of the same exercise completed with an improved metric; the E2E test creates this data itself (bench press set 1: 10 reps, set 2: 12 reps)
- Select a metric worked in the previous full session
- Among "Weight", "Repetitions", "Distance", "Duration"
- Select two exercises for which this metric has improved between previous sets
- Be astonished by the raising curves in the analytics charts