PeachyList Base Plan

1 Login & Account Association Logic

PeachyList uses a phone number-based authentication system that provides secure access while allowing flexible account management. Here's how it works:

First-Time Users and Invited Guests

Both first-time users and invited guests follow the same streamlined login flow:

1. Download the app from your device's app store.
2. Enter a phone number to create or access an account.
3. Receive a text message with a secure confirmation code.
4. Enter the code to gain access to your account.

Account Association Rules

• Each phone number can be linked to only one account at a time.
• To change the association, the number must first be removed from its current account.
• This ensures data security and prevents unauthorized access.

2 Guest Account Management

PeachyList allows account owners to invite and manage guest users, enabling collaborative shopping list management for families, roommates, or team members.

Inviting a Guest

To invite someone to join your PeachyList account:

1. Navigate to the Account tab in the app.
2. Tap the "+ Add guest" button.
3. Enter the guest's phone number (format: (619) 333 - 5555) and click the Add Guest button.
4. Your guest will now have download the app from their device's app store.

Guest Already Registered

If you attempt to invite a phone number that's already registered to another account, the system will display a notification:

This security measure ensures that each phone number maintains a single account association at any given time.

Successful Guest Addition

When a guest successfully accepts your invitation, you'll see a confirmation message:

Removing a Guest

Account owners have full control over guest access and can remove guests at any time:

1. Go to the Account tab.
2. Find the guest you want to remove from your list.
3. Tap the trash can icon.
4. Confirm the removal action.

Guest Notifications

When a guest is removed from an admin account, they should receive a notification informing them that unfortunately they no longer have access to the host's peachy shopping list. This ensures transparency and clear communication about account access changes.

3 Remove Account / Unsubscribe

Account owners have the option to permanently delete their PeachyList account and all associated data.

To remove your account:

1. Navigate to the Account tab.
2. Scroll to find the "Remove account" option.
3. Read the warning message carefully.
4. Tap "Cancel" to abort, or "Remove" to proceed.
5. Confirm your decision.

This action cannot be undone. Please ensure you have backed up any important information before proceeding.

4 Changing Credentials

PeachyList allows you to update your phone number for security or convenience purposes.

How to Change Your Phone Number

1. Go to the Account tab.
2. Tap "Change" link located next to your phone number on the top right of the page.
3. A confirmation code will be sent to your new phone number.
4. Enter the confirmation code you received.
5. Tap "Change" to complete the process.

5 Onboarding Tour

To learn more about this product:

1. Navigate to the Account tab.
2. Look for the "Learn more" button.

1 Initial Store Setup

PeachyList provides flexible store management to accommodate all your shopping needs, from grocery stores to specialty shops.

Empty Account State

In cases where no stores are set up yet, the application will display helpful information to guide users:

2 Store Management Capabilities

The Stores management interface provides comprehensive control over your shopping destinations, enabling full Create, Read, Update, and Delete (CRUD) operations.

Creating a New Store

1. Navigate to the STORES tab.
2. Tap the "+ Add Store" button.
3. Enter the store name (e.g., "Costco", "Walmart", "Trader Joe's").
4. Tap "Add Store" to confirm.

Editing an Existing Store

To modify store details:

1. Find the store you want to edit in the STORES tab.
2. Tap on the edit icon of the store name to edit.
3. Update the store name as needed.
4. Confirm changes to save.

Deleting a Store

Before removing a store, consider the following:

1. Locate the store you wish to remove.
2. Tap the delete or remove option.
3. Review the confirmation dialog.

Store Ordering and Synchronization

PeachyList allows you to arrange your stores in your preferred order:

• The order you establish in the Stores management section is immediately reflected in the horizontal display order of store tabs under the List tab.
• Use the drag handle (the two horizontal bars) on the left of each store to reorder the list.
• Press and hold the handle for one second, then drag the store to its new position.
• Changes sync in real-time across all your devices and with any invited guests.

3 Store List with Items Added

When you have stores configured but no items assigned to them yet, the application provides helpful guidance to get you started.

Transitioning to Active Use

Once you add your first item to a store:

• The informational message disappears.
• The item list becomes visible.
• You can begin managing your shopping list actively.

4 Store Tab Display and Interaction

PeachyList features an intuitive horizontal scrolling interface for managing multiple stores efficiently.

Horizontal Scrolling for Tab Overflow

When the number of store tabs exceeds the available width of the viewport, the tab bar becomes horizontally scrollable (left-to-right). This ensures all your stores remain easily accessible without cluttering the interface.

Active State Indication

Visual feedback helps you always know which store you're viewing:

• When you tap or click on any tab, it immediately adopts the visual 'active' state.
• Active tabs are highlighted with distinct styling (background color, border, or text emphasis).
• This state persists whether the tab is visible in the current view or scrolled out of sight.

Corresponding Content Display

Tapping a store tab triggers an immediate update to the content area:

1. The system displays the list of items belonging exclusively to the newly active store.
2. Items from the previously active store are hidden.
3. The transition is smooth and instantaneous.

1 Item Management

PeachyList provides comprehensive tools for managing your shopping items with flexibility and ease.

Adding a New Item

To add items to your shopping list:

1. Navigate to the LIST tab.
2. Select the store where you want to add the item.
3. Tap the "+ Add Item" button.
4. Enter the item name in the "Item name" field.
5. Set the quantity (defaults to 1).
6. Tap "Add Item" to confirm.

Editing an Existing Item

To modify item details:

1. Locate the item in your list.
2. Tap the pencil (edit) icon next to the item.
3. The "Manage Item" modal will open.
4. Update the item name, quantity, or store assignment as needed.
5. Tap "Save Item" to apply changes.

Deleting Items

Tap the trash/delete icon next to any item for immediate removal.

2 Checked Items Management

PeachyList features an intelligent checked items system that helps you track your shopping progress and manage completed items efficiently.

Checking Items

Tapping the checkmark on an item marks it as completed and moves it to the Checked Items section at the bottom of the screen.

Clearing Checked Items

The "Clear All" link (or button) provides quick cleanup functionality:

After Clearing All Items

After the "Clear All" action is executed:

• The entire "Checked Items" section immediately disappears from the user interface.
• The view returns to the initial state.
• The main shopping list displays only unchecked items.
• This provides a clean slate for your next shopping session.

3 Global Search Functionality

PeachyList includes a powerful global search feature that helps you quickly find items across all your stores, regardless of which tab is currently active.

Search Scope

The search functionality operates with global scope:

• Searches across all available store tabs.
• Returns results for items listed in any store.
• Works independently of the currently active tab.

Results Display Format (Dropdown)

Search results are displayed in a clear, organized dropdown menu using the following format for each entry:

Store Name - Item Name

Example: If "Apples" is in the search query and exists in "Store A," the result displays as:

Store A - Apples

If the same item exists in multiple stores, each occurrence is listed separately:

• Store A - Apples
• Store B - Apples

User Interaction and Navigation

The search feature provides seamless navigation to help you locate items quickly:

Two-Step Navigation Process:

1. Click on a search result line: When you click on any entry in the search dropdown.
2. Automatic tab activation: The system activates and navigates to the chosen Store Tab.

Item Visibility

Once navigation is complete:

• The list of items belonging to that store is displayed.
• The chosen item is placed on top of the item list for immediate visibility, blinking For about 5 seconds before it's placed back to its original position.
• This ensures you can quickly find what you were searching for without scrolling.

Empty State Handling

When an account has no stores set up yet and no items assigned, but a user initiates a search, the system displays:

This messaging guides new users toward the necessary first steps to make their account functional.