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 Trying the App Without an Account

You don't have to sign up to start using PeachyList. On the login screen, tap "Continue without account" to go straight into the app in visitor mode.

What Visitor Mode Includes

• A single fixed store called "My list".
• Full item management — add, edit, delete, check off, and reorder items.
• Everything is saved on your device and persists across app restarts.

What Visitor Mode Does Not Include

• No additional stores — you're limited to "My list".
• No guest invitations or list sharing.
• No cross-device sync — data lives only on the device you used.

3 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.

4 Subscription, Billing & Promo Codes

PeachyList is a subscription app. Your subscription is billed through the store you installed from — the App Store on iOS, Google Play on Android — not directly by Peachy.

Managing Your Subscription

1. Go to the Account tab.
2. Tap "Subscription".
3. The app opens your platform's subscription settings, where you can change plans or cancel.

Redeeming a Promo Code

1. Go to the Account tab.
2. Tap "Redeem Promo Code".
3. Your platform's redemption sheet opens — enter the code there.

If the sheet doesn't open, redeem manually: in the App Store tap your profile and choose "Redeem Gift Card or Code"; in the Google Play Store choose "Redeem code".

Restoring a Previous Purchase

If you've subscribed before — on a new device, or after reinstalling — tap "Restore Purchases" on the subscription screen to reactivate your existing plan without being charged again.

5 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.

6 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.

7 Onboarding Tour

To learn more about this product:

1. Navigate to the Account tab.
2. Tap "Help & Guide" to replay the tour at any time.

Two Kinds of Tour

• A welcome tour of full-screen slides, shown the first time you open the app.
• An interactive tour that highlights each control in place with tooltips.

The app remembers which tours you've completed, so they won't reappear on every launch. You can always start one again from Help & Guide.

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:

Searching From the Stores Tab

The STORES tab has its own search bar at the top, with the placeholder "Search your item". It searches your items across every store, so you can find something without knowing which store it's filed under.

• Results appear in a dropdown formatted as Store Name - Item Name.
• Tapping a result takes you to that item in its store.
• If nothing matches, the dropdown shows "No items found".
• Tap the × in the search bar to clear the query and return to your store list.

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 floating "Add Store" button in the lower corner.
3. The "Manage store" panel opens with a Store name field.
4. Enter the store name (e.g., "Costco", "Walmart", "Trader Joe's").
5. Tap "Save 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 the pencil (edit) icon on the right of the store row.
3. Update the store name as needed.
4. Tap "Save" to apply the change.

Deleting a Store

Before removing a store, consider the following:

1. Locate the store you wish to remove.
2. Tap the trash (delete) icon on the right of the store row.
3. Review the "Delete store" confirmation panel.

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 briefly, then drag the store to its new position.
• The list scrolls automatically when you drag a store toward the top or bottom edge, so you can move a store past the visible screen.
• 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 floating "Add Item" button.
4. The "Manage item" panel opens with three fields side by side.
5. Enter the Item name.
6. Set the Qty (defaults to 1).
7. Optionally enter a Price — used for budget tracking.
8. Tap "Save 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" panel opens, pre-filled with the item's current values.
4. Update the name, quantity, or price as needed.
5. Tap "Save Item" to apply changes.

Deleting Items

Tap the trash (delete) icon next to any item for immediate removal. The edit and delete icons are hidden once an item is checked off — uncheck it first if you need to change it.

2 Store Budgets & Price Tracking

PeachyList can track what you're spending as you shop. Each store carries its own budget, so a $60 grocery run and a $200 warehouse trip are tracked separately.

Setting a Budget

1. Open the LIST tab and select the store.
2. Tap the "$ Set budget" link above the item list.
3. Enter the Amount in the "Set budget" panel.
4. Tap "Save budget".

How the Running Total Works

Only items you have checked off count toward what you've spent — the total reflects what's actually in your cart, not what's still on the list.

• The budget bar shows Budget $60.00.
• Once you check off your first item it also shows | Remain $44.50.
• Each item displays its own price beside its name.

Prices Are Optional

Items without a price count as $0.00. You can set a budget and only enter prices for the expensive items you actually want to watch.

Clearing a Budget

Tap the × on the budget bar to remove the budget for that store. Your items and their prices are kept — only the budget and the running total go away, and the bar returns to the "$ Set budget" link.

3 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 circular checkmark on an item marks it as completed and moves it to the Checked Items section at the bottom of the screen, below a separator line.

The Checked Items Header

What the header shows depends on whether the store has a budget:

• Without a budget: the number of checked items and their total quantity — e.g. Items 4   Quantity 7.
• With a budget: the total quantity plus what you've spent — e.g. Quantity: 7 and Total: $15.50.

Clearing Checked Items

The clear action sits in the checked items header. It reads "Delete checked" normally, or "Clear checked" when a budget is set:

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.

4 Swipe & Drag Gestures

Beyond tapping, the LIST tab supports gestures that make everyday shopping faster.

Swipe Between Stores

Swipe left or right anywhere on the item list to move to the next or previous store — no need to reach up and tap a store tab. Swiping stops at the first and last store rather than wrapping around.

Drag to Reorder Items

Press and hold an item, then drag it up or down to reorder your list. Arrange items in the order you walk the aisles so your list matches the store layout.

• The item lifts with a shadow so you can see what you're moving.
• Dragging toward the top or bottom edge scrolls the list automatically.

Drag to Reorder Store Tabs

The store tabs across the top can be dragged into a different order too. The order you set is shared with the STORES tab — reordering in one place updates the other.

5 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.