US2: Onboarding

[jacknystrom]

User Story: Onboarding Page for New Users in To-Do Planner App

Title: Onboarding Page for Profile Setup

---

Scenario 1: New user opens the app for the first time

Given:

• The user has downloaded and opened the To-Do Planner app for the first time.

When:

• The app detects that the user has no existing profile.

Then:

• The user is taken to an onboarding page prompting them to submit their profile details (profile picture, name, and birthday).

---

Scenario 2: User uploads a profile picture

Given:

• The user is on the onboarding page with fields for profile picture, name, and birthday.

When:

• The user selects the "Upload Profile Picture" option.

Then:

• The user can choose an image file from their device (accepted formats include .jpg and .png).

And:

• If the file is valid (format and size), it will be previewed in the profile picture field.

And:

• If the file is invalid, an error message is displayed, and the user must try again.

---

Scenario 3: User skips the profile picture upload

Given:

• The user is on the onboarding page with fields for profile picture, name, and birthday.

When:

• The user chooses not to upload a profile picture and skips this step.

Then:

• The user can proceed without uploading a profile picture.

And:

• The "Submit" button will not be disabled because the profile picture is optional.

---

Scenario 4: User inputs their name

Given:

• The user is on the onboarding page.

When:

• The user enters their name in the "Name" input field.

Then:

• The system validates that the field is not left blank.

And:

• If the field is blank, an error message is shown, and the user cannot proceed until the name is entered.

---

Scenario 5: User inputs their birthday

Given:

• The user is on the onboarding page.

When:

• The user selects their birthday using the date picker.

Then:

• The date picker ensures that a valid date format (DD/MM/YYYY or MM/DD/YYYY based on locale) is selected.

And:

• If the user enters an invalid date, an error message is displayed.

---

Scenario 6: User submits the onboarding form

Given:

• The user has uploaded a valid profile picture (optional), entered a valid name, and selected a valid birthday.

When:

• The user clicks the "Submit" button.

Then:

• The system validates that all required fields (name and birthday) are correctly filled in.

And:

• If validation is successful, the user is redirected to the tasks page.

---

Scenario 7: User encounters validation errors during submission

Given:

• The user has attempted to submit the onboarding form.

When:

• One or more required fields (name or birthday) are missing or invalid.

Then:

• The system prevents the form from being submitted and shows appropriate error messages.

And:

• The user is prompted to correct the errors before submitting again.

---

Scenario 8: Successful redirection to the tasks page

Given:

• The user has successfully submitted their profile information.

When:

• The system confirms the form is valid.

Then:

• The user is redirected to the tasks page to start managing their to-do list.

And:

• The profile information is saved and can be accessed or edited later from the settings page.