Usage
=====

This guide walks through the main user flow in Parking App, from signing in to ending a parking session.

Quick start
-----------

1. Open the app.
2. Sign up for a new account, or log in with an existing account.
3. Allow location access when prompted.
4. Search for a nearby car park.
5. Start a parking session.
6. Extend, cancel, or let the session finish.
7. Leave a review and check your session history.

Screenshots
-----------

The screenshots below show the main screens users move through during the app flow.

Login
-----

.. figure:: images/login-screen.png
   :alt: Login screen with email and password fields
   :width: 400
   :align: center

   The login screen where users enter their credentials

Sign up
-------

.. figure:: images/sign-up-screen.png
   :alt: Sign up form with first name, last name, email, and password fields
   :width: 400
   :align: center

   The sign up screen used to create a new account

Settings
--------

.. figure:: images/settings-page.png
   :alt: Settings screen showing notification and app preference toggles
   :width: 400
   :align: center

   The settings screen where users adjust app preferences

Search
------

.. figure:: images/search-screen.png
   :alt: Search screen with a location search bar, map, and car park filters
   :width: 400
   :align: center

   The search screen used to find nearby car parks

History
-------

.. figure:: images/reviews.png
   :alt: History screen listing recent reviews and session activity
   :width: 400
   :align: center

   The history and reviews screen

Home
----

.. figure:: images/home-screen.png
   :alt: Home screen showing the active session area and nearby car parks
   :width: 400
   :align: center

   The home screen where users start and manage a parking session

Profile
-------

.. figure:: images/profile-page.png
   :alt: Profile page showing account details and user information
   :width: 400
   :align: center

   The profile page for viewing account details

Create an account or log in
---------------------------

On first launch, you will see the authentication screen.

Sign up
-------

1. Tap **Sign up**.
2. Enter your first name, last name (Optional), email, and password.
3. Submit the form to create your account.

Log in
-------

1. Enter your email and password.
2. Tap **Log in**.
3. After successful login, you will be taken to the main app view.

Find a car park
---------------

The search view lets you find and navigate to parking options.

1. Allow location permissions so the app can use your current position.
2. Enter a destination or search query.
3. Adjust minimum and maximum distance filters if needed.
4. Review returned car parks.
5. Select a car park to view route and navigation directions.

The app can provide turn-by-turn guidance and voice prompts while navigating.

Start and manage a parking session
----------------------------------

After selecting a car park, start a parking session and monitor time remaining.

Start session
-------------

1. Choose a car park.
2. Select your parking duration.
3. Start the session.

While active
------------

- The timer shows remaining time.
- You can add 30 minutes to extend your session.
- You can cancel the session early if your plans change.

End session
-----------

When the timer reaches zero or you cancel manually, the session ends and can be reviewed.

Review, profile, and history
----------------------------

After a session, you can:

- Leave a rating and review for the car park.
- Open **History** to see previous parking sessions.
- Open **Profile** to view your account information.
- Open **Settings** to adjust app preferences.

Troubleshooting
---------------

- If no car parks appear, check your internet connection and search filters.
- If your position is wrong, make sure location services are enabled on your device.
- If login fails, verify your email and password, then try again.