PeachyList Base Plan

Your Complete Guide to Shopping List Management

📚 Quick Navigation

🔐 Login & Account Management

Understanding user authentication and account association

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.
Smart Account Detection: When a phone number is entered, the system automatically checks whether it already exists in the database. If the number is found, access is granted to the associated account. If not, a new account is created seamlessly.

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.
Important Example: If a user is currently listed as a guest under Account A but needs to join Account B, the admin of Account A must first remove that user from the guest list. Only then can an invitation from Account B be sent and accepted.

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.
Important Note: Each guest you add will have access to your shared shopping lists and can create items across all stores. Make sure you trust the people you invite to your account.

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 guest's phone number is already in use. To add them to your list, they must first be removed from the other account."

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:

Success!
"(619)333 - 5555 has accepted your invitation and is now part of your Peachy team. You can manage guests in the Account tab."

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.
What Happens When You Remove a Guest:
  • The guest (e.g., (619) 333 - 5555) will no longer have access to your shopping lists on their account.
  • Any public lists they created will remain available, while private lists will be permanently deleted.
  • If the guest had access to your host phone number through PeachyList, that access will be revoked.

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

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

Critical Warning: If you choose to remove your account, you and all of your invited guests will be immediately logged out of the service. All user data, including stores, items, and lists, will be permanently and irreversibly removed and cannot be recovered.

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.
Security Measure: The confirmation code ensures that only the rightful account owner can make changes to account credentials, protecting your data from unauthorized access.

5 Onboarding Tour

To learn more about this product:

  1. Navigate to the Account tab.
  2. Look for the "Learn more" button.
Tour Coverage: The onboarding tour covers navigation between tabs, account management features, store organization, list management, and collaboration features for both admin users and guests.

🏪 Stores Management

Organize your shopping destinations and manage store information

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:

Getting Started:
"Add your first store to start organizing where you shop. Add any store you like to shop at. Tap + Add Store to get started."

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.
The new store will appear in your store list and will be available for item assignment immediately.

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.
Flexibility: You can update store information at any time. Changes are reflected immediately across all associated items and lists.

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.
Confirmation Required:
"Are you sure you want to remove this store? All items currently assigned to this store will be removed from your list."

Tap "Cancel" to keep the store, or "Confirm" to proceed with deletion.

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.
Pro Tip: Organize your stores by shopping frequency or geographical proximity to make your shopping trips more efficient.

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.

Ready to Shop:
"Add any items you like to shop. Tap + Add Item to get 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.
Smart Navigation: The active store tab automatically scrolls to the center of the screen for optimal visibility, making it easy to see which store you're currently managing.

📋 List Management

Master your shopping list with powerful item management tools

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.
Smart Field Population: When you trigger the 'Edit' pencil icon on a list item, the "Manage Item" modal opens with the item name field pre-populated and the current quantity displayed in the "Quantity" field. This pop-up enables you to modify the item's name, adjust its quantity, and change its store assignment (including removal if quantity is set to 0).

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:

Permanent Deletion: This action permanently removes all items currently listed under the "Checked Items" section. Use this feature after completing your shopping trip to reset your list for next time.

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.
Cross-Store Discovery: If you're viewing "Costco" but search for an item that's actually in "Trader Joe's," the search will still find it and show you exactly where it's located.

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.
Smart Highlighting: The searched item appears at the top of the list, making it instantly visible when you arrive at the correct store tab.

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:

No items found

Along with helpful guidance:

"Add your first store to start organizing where you shop. Add any store you like to shop at. Tap + Add Store to get started."

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