🛒

ShopShare

User Manual
v1.0.0
🛒

Welcome to ShopShare

ShopShare is your family shopping list app. Add items, share lists in real time, and shop smarter together.

Getting Started

🤝
Family Sharing
Real-time collaboration with your household
📶
Real-time Sync
Changes appear instantly on all devices
📵
Offline Support
Works without internet, syncs when reconnected
🎤
Voice Input
Add items hands-free
🏷️
8 Categories
Smart auto-categorization
📊
Stats & History
Track what you bought and when

Signing In

ShopShare uses Google Sign-In for quick and secure access. No separate password needed.

  1. Open ShopShare on your Android device. The sign-in screen appears.
  2. Tap "Continue with Google" and select your Google account.
  3. Allow permissions if prompted (microphone for voice input).
  4. Done! Your personal list is created automatically on first sign-in.
💡
Your data is stored in Firebase and synced to every device you sign in with the same Google account.

Home Screen Overview

📱 Home Screen Layout
ElementWhat it does
My List / Shared / Search tabsSwitch between your lists and search mode
📅 Calendar icon (top bar)View and manage Today's List
👁️ Eye icon (top bar)Toggle visibility of completed items
🧹 Sweep icon (top bar)Delete all completed items at once
👤 Avatar (top right)Profile, settings, invite members, sign out
Category chips (below tabs)Filter items by category
+ FAB button (bottom right)Add a new item
📋

My Lists

Manage personal and shared shopping lists. Switch between them with one tap.

Two Types of Lists

👤 Personal List

Private, visible only to you. Auto-created on sign-up. Named MyList_YourName.

ℹ️
Personal lists cannot be shared. Create a Shared List to collaborate.
👥 Shared List

Collaborative list for family members. Syncs instantly across all devices. Named FamilyList_Name.

Switching Between Lists

  1. Look at the oval tab bar below the app title: My List, Shared, Search.
  2. Tap My List to view your personal list.
  3. Tap Shared to switch to your family list.
ℹ️
The app remembers your last active list when you reopen it.

Creating a Shared List

  1. Tap avatar (top right) → Invite Member.
  2. Tap Create a Shared Family List.
  3. Enter a name (e.g., Smith). Full list name: FamilyList_Smith.
  4. Tap Create. The app switches to the new shared list.
💡
Free plan: 1 shared list. Family plan: 3. Group plan: 10.

List Limits by Plan

PlanOwned ListsJoined ListsMembersHistory
FREE12530 days
FAMILY351090 days
GROUP101025Unlimited
+

Add an Item

Add groceries, electronics, clothing — anything you need — to your list in seconds.

Adding an Item Manually

  1. Tap the + button (purple FAB, bottom right of home screen).
  2. Type the item name. After 3+ characters, autocomplete suggestions appear. Tap a suggestion to auto-fill name and category.
  3. Select category — auto-detected, or change it using the dropdown.
  4. Set quantity and unit (pcs, kg, g, L, ml, dozen, box, pack, bunch, pair, bag, bottle, can, strip).
  5. Add notes (optional) — brand preference, size, etc.
  6. Tap Add to list. Item appears instantly.
💡
ShopShare knows 500+ Indian and international items: Atta, Dal, Ghee, Sabzi, Kurta, Headphones and more. Smart Hindi keyword detection included.

Available Categories

🛒
Grocery
Food, staples, vegetables, dairy, fruits, spices
💻
Online
Items ordered online
🏪
Physical
From local shops, malls
👕
Wearables
Clothes, footwear, accessories
🏠
Home & Living
Cleaning, kitchen, decor
💊
Health & Beauty
Medicine, shampoo, skincare
🎮
Electronics
Phones, gadgets, cables
📚
Education
Books, stationery
📦
Other
Anything else
🎤

Add by Voice

Add items completely hands-free using speech recognition.

Using Voice Input

Voice input works in two steps: first say the action word, then say the item name.

  1. Tap the microphone icon on the home screen. A bottom sheet slides up.
  2. Say "Add" — say "Add", "Add item", or "Please add". The status text changes.
  3. Say the item name clearly: "Milk", "2 kg Atta", "Toothpaste".
  4. Review — the detected name and auto-detected category appear. Edit if needed.
  5. Tap "Add to List". The item is added and the sheet closes.
💡
Say it in one go: "Add Milk" or "Add 2 packets Atta" — ShopShare skips straight to confirmation.
  • Include quantities: "3 kg rice", "2 dozen eggs", "1 bottle shampoo"
  • Filler words are ignored: "please", "buy", "get", "I need"
  • Tap Retry if recognition is incorrect
  • Tap the mic button again to stop listening
⚠️
Requires microphone permission. If denied: Settings → Apps → ShopShare → Permissions → Microphone → Allow.
StepSayMic Ring Color
Step 1 – Action"Add", "Add item", "Please add"Cyan / Blue
Step 2 – Item nameThe item (e.g., "Tomatoes")Purple
✏️

Edit an Item

Update the quantity, unit, or notes on any item in your list.

Edit Quantity and Unit

  1. Find the item. Look for the quantity chip below the name (e.g., 2 kg or x3). It shows a small pencil icon.
  2. Tap the quantity chip. A bottom sheet slides up.
  3. Enter the new quantity and select the unit from the dropdown.
  4. Tap the checkmark to save. The card updates immediately.
💡
Changes to shared list items sync instantly to all family members.

Notes

Notes are set when you first add an item. To change notes on an existing item, delete it and re-add with updated notes. Notes appear in italic below the item name on the card.

ℹ️
Full inline editing (name, category, notes) is planned for a future ShopShare update.
📦

Move Items

Move items between lists or copy them to Today's List for your shopping trip.

Select Items to Move

  1. Tap the checkbox on the right side of any item card. The card highlights purple and a counter appears in the top bar.
  2. Select more items if needed (bulk move).
  3. Tap the Move icon in the toolbar. The Move dialog appears.
💡
Tap the deselect icon (X) in the top bar to clear all selections.

Where Can You Move Items?

DestinationWhat Happens
Today's ListCopies item to Today's List. Original stays in the source list.
Shared ListMoves item to your shared family list. Removed from current, added to shared.
Another Personal ListMoves item to another personal list (if you have multiple).

Move to Today's List

  1. Select items using checkboxes.
  2. Tap Move in the top bar.
  3. Tap Today's List in the dialog. A green toast confirms.

Move to Shared List

  1. Select items from your personal list.
  2. Tap Move then the shared list name in the dialog.
  3. Items are removed from personal and instantly added to shared. All members see them.
ℹ️
The Move option only appears in the toolbar when one or more items are selected.
🗑️

Delete Items

Remove items by swiping, bulk-delete selected items, or clear all completed at once.

Swipe to Delete (Single Item)

  1. Swipe the item card left. A red delete background appears.
  2. A confirmation dialog appears. Tap Delete to confirm permanently.
⚠️
Deletion is permanent and cannot be undone. There is no recycle bin.

Bulk Delete (Multiple Items)

  1. Tap the checkboxes on the right side of item cards to select multiple items.
  2. Tap the red trash icon that appears in the top bar.
  3. Confirm in the dialog. All selected items are permanently removed.

Delete All Completed Items

  1. Tap the orange sweep icon in the top bar (turns orange when completed items exist).
  2. A dialog shows how many completed items will be deleted.
  3. Tap Delete. All completed items are removed.
💡
To hide completed items without deleting, use the eye icon (Show/Hide completed) instead.
🏷️

Categories & Filters

Filter your list by category to focus on one section of the store at a time.

Using Category Filters

Category filter chips appear in a horizontal scrollable row just below the tab bar.

  1. Look at the chip row below the My List / Shared / Search tabs.
  2. Tap any category chip (e.g., Grocery). The list filters instantly. The chip turns solid colored.
  3. Tap All (first chip) to remove the filter and show everything.
💡
Category filtering works on both personal and shared lists.

Category Reference

CategoryColorTypical Items
GroceryGreenAtta, Dal, Rice, Milk, Vegetables, Fruits, Spices, Oil, Tea
OnlineBlueItems ordered from Amazon, Flipkart etc.
PhysicalOrangeItems from local shops, malls, markets
WearablesPurpleKurta, Jeans, Shoes, Saree, Shirt, Cap
Home & LivingTealSoap, Detergent, Broom, Towel, Pan, Curtains
Health & BeautyPinkShampoo, Toothpaste, Cream, Dawa, Vitamin
ElectronicsIndigoPhone, Charger, Headphones, Cable, Laptop
EducationAmberBook, Pen, Pencil, Notebook, Eraser, Ruler
OtherGreyAnything that does not fit other categories

Auto-Detection

ShopShare auto-detects category using a 500+ item catalog and keyword patterns including Hindi and Indian words. You can always manually change the category using the dropdown on the Add Item screen.

🔍

Search

Find any item quickly by name, category, or the date it was added.

Using Search

  1. Tap the Search tab in the oval menu bar. The keyboard opens automatically.
  2. Type to search by item name or category. Results update instantly.
  3. To clear, tap X in the search field or switch to another tab.
💡
Search is case-insensitive. Partial matches work: type "tom" to find "Tomatoes", "Tomato sauce" etc.

Filter by Date

  1. In the Search tab, tap the Filter by date chip below the search box.
  2. A calendar opens. Select a date.
  3. Only items added on that date are shown. A date chip appears — tap X to remove it.
ℹ️
Text search and date filter can be active at the same time to narrow down a specific item from a specific day.
📅

Today's List

A quick in-session checklist for your shopping trip. Check off items as you buy them!

What is Today's List?

Today's List is a temporary in-memory checklist. It does not sync to the cloud and resets when you close the app.

📅 Key Facts
  • Items are copied from your main list into Today's List
  • Does not sync to cloud or other devices
  • Completing items here also marks them done in the main list
  • Calendar icon turns bright green when Today's List has items
  • Resets when you close the app

Add Items to Today's List

  1. Select items on the home screen using the checkboxes on the right of each card.
  2. Tap the Move icon in the top bar.
  3. Tap Today's List in the dialog. A green toast confirms.

View and Complete

  1. Tap the green calendar icon in the top bar.
  2. Check off items you have bought using the checkboxes.
  3. Tap Hurray! Completed to mark all done, or Complete (X) for selected only.
  4. Done items are marked complete in the main list and removed from Today's List.
💡
Tap Clear List to remove all items without marking them as completed.

Completed Items

Track bought items, toggle visibility, restore them, or clear them all.

Mark an Item as Complete

  1. Tap the circle icon on the left of any item card. It becomes a checkmark with strikethrough.
  2. The card shows who completed it and when (e.g., "Rahul · 2h ago").
  3. Tap the checkmark again to uncheck and restore the item to pending.
ℹ️
In a shared list, all members can see who marked each item as completed and when.

Show and Hide Completed

  1. Tap the eye icon in the top bar to toggle visibility.
  2. Eye open = completed items shown at bottom with strikethrough.
  3. Eye closed = completed items hidden.
💡
Hiding completed items makes it easier to focus on what you still need to buy.

History Limits by Plan

PlanHistory
FREE30 days
FAMILY90 days
GROUPUnlimited
👥

Create a Shared List

Create a family list so everyone can add items and shop together in real time.

Create Your Shared List

  1. Tap your avatar (top right) and select Invite Member.
  2. Tap Create a Shared Family List.
  3. Enter a name (e.g., Smith, Gupta, Kitchen). The full name will be FamilyList_Smith.
  4. Tap Create. The app switches to the new list.
💡
Your List ID appears on the Manage Members screen after creating. Share this ID so family members can join.

Owner Permissions

As the list owner, you can: invite and remove members, add/edit/delete items, share the List ID, and see the full member list. Members can add/edit/delete items but cannot invite others.

⚠️
If you delete your account, all shared lists you own are deleted permanently. All members lose access.
📨

Invite Members

Invite family members to join your shared list via WhatsApp, Email, or any app.

How to Invite

  1. Switch to your Shared List (Shared tab).
  2. Tap avatar (top right) and select Invite Member.
  3. You will see the List ID card at the top. Choose how to share:
💬 WhatsApp

Tap WhatsApp. A pre-written invite message opens. Send to a contact.

📧 Email

Tap Email. Your email app opens with a pre-filled invite message.

📤 More / Other Apps

Tap More to open the system share sheet: Telegram, SMS, copy to clipboard, etc.

📋 Copy List ID

In the List ID card, tap the copy icon to copy to clipboard. Paste it manually anywhere.

Member Limits

PlanMax Members per List
FREE5 members
FAMILY10 members
GROUP25 members
ℹ️
Only the list owner can invite new members. Members cannot invite others.
🔗

Join a Shared List

Have a List ID? Enter it to join someone's shared shopping list.

How to Join

  1. Ask the list owner for their List ID.
  2. Tap avatar (top right) → Invite Member.
  3. Scroll to the Join a Shared List section at the bottom.
  4. Paste or type the List ID in the input field.
  5. Tap Join. The app switches to the shared list.
💡
Free plan: join up to 2 lists. Family: 5. Group: 10.

After Joining

  • You become an Active member and can see and edit all items
  • Your name appears in the members list
  • You cannot invite other members (only the owner can)

Possible Errors

ErrorSolution
List not foundDouble-check the ID and try again
Already a memberSwitch to the Shared tab to view the list
Joined list limit reachedUpgrade your plan
👬

Manage Members

View current members, check their status, and understand owner vs member roles.

Viewing Members

  1. Tap avatar (top right) → Invite Member.
  2. Scroll to Current Members. See each member's name, email, and status.
Status BadgeMeaning
ActiveMember has joined and can access the list
PendingInvited but has not joined yet

Owner vs Member

👑 Owner
  • Creates the list
  • Invites and removes members
  • Full item control
  • Sees List ID and invite buttons
👥 Member
  • Joins via List ID
  • Can add, edit, delete items
  • Cannot invite others
  • Can see other members
ℹ️
The owner role cannot currently be transferred. If the owner deletes their account, the list is deleted for all members.
🎨

Themes

Three beautiful themes to match your style.

Changing the Theme

  1. Tap your avatar (top right) and select Settings.
  2. Under Appearance, find the Theme tile.
  3. Tap your preferred theme. The app updates instantly.
🌟
System
DEFAULT
  • Follows device setting
  • Light in day, dark at night
  • Purple / teal palette
🌿
Soothing
CALM
  • Soft sage green palette
  • Warm white background
  • Easy on the eyes
🌃
Vibrant Dark
NIGHT
  • Deep navy background
  • Electric purple accents
  • Great for night use
💡
Theme choice is saved and remembered next time you open ShopShare.
🔔

Notifications

Control when ShopShare notifies you. Mute for hours or days.

Notification Settings

  1. Tap avatar then Settings.
  2. Under Notifications, choose your mode.
OptionWhat it Does
Always onNotifications enabled at all times (default)
Mute 8 hoursMutes for the next 8 hours
Mute 24 hoursMutes for 24 hours
Custom...Choose 1 to 30 days to mute

To re-enable: Settings → Notifications → tap Always on.

ℹ️
Mute settings are local and do not sync across devices.
👤

Profile

Edit your name, gender, copy your List ID, and view shopping stats.

Edit Your Profile

  1. Tap avatar then My Profile.
  2. Tap the pencil icon (top right) to enter edit mode.
  3. Update Display Name and/or Gender. Tap Save.
💡
Your display name is shown to all members in shared lists when you add or complete items.
FieldDescriptionEditable?
Display NameShown to other membersYes
GenderAffects avatar icon (Male/Female/Other)Yes
EmailGoogle account emailNo
PlanFree, Family, or GroupNo
List IDPersonal list ID, tap copy icon to copyNo

Shopping Stats

🛒
Items Added
Total items you have added
Completed
Items marked as done
Pending
Items still to buy
👥
Members
Members in your current list
💎

Subscription Plans

Three plans for different household sizes.

Available Plans

Free Plan
FREE
  • 1 personal list
  • 1 owned shared list
  • Join 2 shared lists
  • 5 members per list
  • 30 days history
Family Plan
FAMILY
  • 1 personal list
  • 3 owned shared lists
  • Join 5 shared lists
  • 10 members per list
  • 90 days history
Group Plan
GROUP
  • 1 personal list
  • 10 owned shared lists
  • Join 10 shared lists
  • 25 members per list
  • Unlimited history

Plan Comparison

FeatureFREEFAMILYGROUP
Owned Shared Lists1310
Joined Lists2510
Members per List51025
Item History30 days90 daysUnlimited
Voice InputYesYesYes
Offline SupportYesYesYes
ℹ️
Your current plan is shown on the Profile screen. Use Settings → Feedback to contact support.
🔒

Account

Manage your sign-in, sign out, and account deletion.

Sign Out

  1. Tap your avatar (top right) and select Sign Out, or go to Settings → Account → Sign Out.
  2. Confirm in the dialog. Tap Sign Out.
  3. You are taken to the login screen. Your data stays in the cloud.
💡
Sign back in anytime with the same Google account to access all your data.

Delete Account

Account deletion is permanent and irreversible.

⚠️
Warning: Deletes ALL your lists, items, shared lists you own (all members lose access), and profile data. Cannot be undone.
  1. Go to Settings → Account → Delete Account.
  2. Read the warning. Tap Continue.
  3. Type DELETE (all caps) to confirm.
  4. Tap Delete My Account. Deletion begins immediately.
ℹ️
If you get a requires-recent-login error, sign out and sign back in first, then try again.
?

FAQ & Troubleshooting

Common questions and solutions.

Frequently Asked Questions

Why are my items not showing on my family member phone?
Make sure both are on the Shared tab (not My List). Personal list items are private. Check internet - items sync in real time when online.
I invited someone but they show as Pending.
They need to open ShopShare, tap avatar, then Invite Member, scroll to Join a Shared List, enter the List ID, and tap Join.
Can I use ShopShare without internet?
Yes. Offline support is built in via local cache. Changes sync automatically when back online.
I accidentally deleted an item. Can I restore it?
No. Deleted items are permanent. Use the eye icon to hide completed items instead of deleting.
Voice input is not working.
Check microphone permission: Settings then Apps then ShopShare then Permissions then Microphone then Allow. Say Add first, then the item name.
Old completed items are not showing.
History limits: 30 days (Free), 90 days (Family), Unlimited (Group). A notice appears when items are hidden due to limits.
How do I change my display name?
Tap avatar, then My Profile, tap the pencil icon, update name, tap Save.
Items are not syncing to my other device.
Check internet connection on both devices. Make sure same Google account. Try signing out and back in on the affected device.
How do I send feedback or report a bug?
Settings then Support then Feedback / Report Issue, type message (max 300 chars), tap Submit.