User Guide

This guide explains the normal shopping workflow.

Open the app in a browser.
Use Register to create an account, or Login if you already have one.
Usernames are normalized to lowercase.
Passwords must be at least 8 characters.

The app keeps you signed in with a secure session cookie. If your session expires, the app redirects you back to login.

Create Or Join A Household

A household is the group that owns lists, stores, locations, invite links, and members.

If you have no household:

Open the household prompt from the main list or manage area.
Choose Create Household to start a new household.
Choose Join Household if someone sent you an invite link.

If you belong to multiple households, use the household switcher in the navigation bar. The app remembers the active household in your browser.

Choose A Store Location

The grocery list is scoped to a household store location.

Use the store tabs near the top of the grocery list.
Pick the location you are shopping at.
If there are no stores, ask a household owner/admin to add one from Manage > Stores.

The app remembers the active store location for each household.

Add Grocery Items

On the main list:

Type an item name.
Set the quantity.
Choose Add or Create + Add.
If the item already exists, confirm whether to add to the existing quantity.
Optionally add item details, classification, notes, or an image when prompted.

Suggestions appear from the household/location catalog and previous items.

Mark Items Bought

Use the item action to mark an item as bought. Depending on your settings, the app may ask you to confirm before buying.

Bought items move out of the active list and can appear in Recently Bought (24HR). This section helps recover accidental purchases or review what was just picked up.

Search The List

Use Search list to filter visible list items. Search works on the current household/location list.

When search is active:

Matching items remain visible.
Empty zone sections are hidden.
Collapsed zones are expanded for easier scanning.

Images

Items can have product images. Images are uploaded through the app and processed by the backend.

If the network drops during an image upload:

The upload queue keeps track of the failed upload.
The upload toaster shows progress, success, or failure.
You can retry or discard a failed upload.

Do not upload sensitive photos or receipt images unless the feature you are using explicitly expects them.

Settings

Open Settings from the user menu.

Available settings include:

Theme: light, dark, or auto.
Recently bought visibility.
Number of recently bought items to show.
Whether recently bought starts collapsed.
Confirm before marking bought.
Auto reload interval.
Haptic feedback.
Debug mode.

Settings are stored in your browser for your username.

Permissions You May See

Fiddy has two role layers:

System role: normal users generally use the app; system admins can access the admin panel.
Household role: owner, admin, or member within each household.

Household owners/admins can manage members, invite links, stores, locations, zones, and catalog defaults. Members can use the list and participate in household shopping.