> ## Documentation Index
> Fetch the complete documentation index at: https://poolerz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# UI Design

> The UI design of Poolerz.

Our application consists of three primary sections: **Carpools**, **Profile**, and **Dashboard**. These sections offer key functionalities such as joining, creating, and optimizing carpools, as well as viewing event calendars. Below is a detailed breakdown of selected screens and design reasoning behind them. The focus of these interfaces is on **joining or creating a carpool** and the ability to **view and optimize carpool groups**.

***

## **Figure 4.1 - Carpooling Home Page**

<img src="https://mintcdn.com/poolerz/QJ_9o0D7RJnmN_4g/images/fig9.png?fit=max&auto=format&n=QJ_9o0D7RJnmN_4g&q=85&s=7a4dc359e87fe3ec0ce862c7f3b33b40" alt="Carpooling Home Page" width="1918" height="799" data-path="images/fig9.png" />

The **Carpooling Home Page** is the core screen, allowing users to:

* **Create a new carpool**
* **Join an existing carpool**
* **View all current carpools**

### **Design Features:**

#### **Usability Heuristics:**

1. **Aesthetic and Minimalist Design:**
   * **Clean layout** with essential options for a clutter-free experience.
   * **Brand colors** (blue and yellow) create a clear visual hierarchy, enhancing readability.
   * **White space** and **tabs** balance the design without extraneous elements.

2. **Match Between System and Real World:**
   * Simple terminology like "Create Carpool", "Join Carpool", and "Current Carpools" mirrors real-world language, making it intuitive.
   * **Navigation arrows** mimic common patterns used in other apps, signaling clickable elements.

3. **Consistency and Standards:**
   * **Uniform design** of buttons and text styles across the app, ensuring consistent user expectations.
   * Navigation menu placement follows common web app conventions.

***

## **Figure 4.2 - Create Carpool Page**

<img src="https://mintcdn.com/poolerz/QJ_9o0D7RJnmN_4g/images/fig10.png?fit=max&auto=format&n=QJ_9o0D7RJnmN_4g&q=85&s=610886085bc8e72373fc85c43760c658" alt="Create Carpool Page" width="1915" height="828" data-path="images/fig10.png" />

The **Create Carpool Page** allows users to input details for creating a new carpool organization. This page includes fields for:

* **Carpool name, address, time**, etc.
* **Personal information** such as driving availability, car capacity, and any notes for other members.

### **Design Features:**

#### **Usability Heuristics:**

1. **Error Prevention:**
   * Required fields are marked with **red asterisks** to guide users.
   * **Disabled "Continue" button** until required fields are filled to prevent incomplete submissions.
   * **Logical grouping** of inputs to minimize errors.

2. **User Control and Freedom:**
   * **Editable fields** allow users to adjust details before submission.
   * **Toggle selections** for days, riders, and availability make corrections quick and easy.
   * **Back button** offers an escape without committing to changes, with a confirmation modal for added security.

3. **Visibility of System Status:**
   * **Progress indicators** like location, schedule, and car capacity help users track their setup.
   * **Highlighted selected days** and availability provide visual confirmation of choices.

***

## **Figure 4.3 - Carpool Information Page**

<img src="https://mintcdn.com/poolerz/QJ_9o0D7RJnmN_4g/images/fig11.png?fit=max&auto=format&n=QJ_9o0D7RJnmN_4g&q=85&s=3d9527b779bd6224d71b87ead02a3d58" alt="Carpool Information Page I" width="1999" height="1428" data-path="images/fig11.png" />

<img src="https://mintcdn.com/poolerz/QJ_9o0D7RJnmN_4g/images/fig12.png?fit=max&auto=format&n=QJ_9o0D7RJnmN_4g&q=85&s=037b5b226b2e904c2f4b8af9fb7758d3" alt="Carpool Information Page II" width="1999" height="991" data-path="images/fig12.png" />

The **Carpool Information Page** is where users and administrators can view and manage carpool data. Key features include:

* Viewing **carpool and personal information**
* For admins, the ability to **run the optimizer** to group members into carpools.

### **Design Features:**

#### **Usability Heuristics:**

1. **Visibility of System Status:**
   * **Clear messaging** about carpool assignments, showing when no groups are assigned and updates once the optimizer is run.
   * **"Run Optimizer" button** guides admins on next steps, improving clarity and flow.

2. **Flexibility and Efficiency of Use:**
   * **Efficient layout** allows quick access to relevant info without unnecessary steps.
   * Admins can **edit carpool and personal details**, while the **optimizer automates grouping**, making the process faster and more flexible.

3. **Recognition Rather than Recall:**
   * **Clear display of information** like assigned groups, driving days, and member statuses.
   * Divided sections (e.g., **"Organization Information", "My Information", "My Pool"**) help users find details without recalling specifics.

***

**Summary:**\
The UI design follows Nielsen’s Usability Heuristics to create a **user-friendly, efficient, and intuitive experience** across the application. From a clean, minimalist layout to structured user flows and error prevention, each screen aims to enhance user satisfaction and engagement. The consistency and clarity in design ensure users can easily navigate through creating, joining, and managing carpools with ease.
