Quick Start Guide¶
Get up and running with ShopSync in just a few minutes! This guide is for end users who want to start using the app right away.
Choose Your Platform¶
Using ShopSync on the Web¶
- Visit the App
Go to app.shopsync.aadish.dev
-
Sign In
-
Click the "Sign in with Google" button
- Select your Google account
-
Grant necessary permissions
-
Start Creating Lists
You're ready! Create your first shopping list by clicking the + button.
Add to Home Screen
ShopSync is a Progressive Web App (PWA). You can add it to your home screen for a native app experience:
- Chrome: Menu → Add to Home Screen
- Safari: Share → Add to Home Screen
Installing on Android¶
- Download from Play Store
- Install the App
Tap Install and wait for the download to complete.
- Open ShopSync
Launch the app from your home screen or app drawer.
-
Sign In
-
Tap "Sign in with Google"
- Select your Google account
-
Grant necessary permissions
-
Enable Home Widget (Optional)
-
Long-press on your home screen
- Tap Widgets
- Find ShopSync widgets
- Drag your preferred widget to the home screen
Using on WearOS¶
Requires Android App
WearOS support is included with the Android app. Install the Android app first.
- Install Android App
Download and install ShopSync from the Play Store on your phone.
- Automatic Sync
The WearOS companion app will automatically install on your paired smartwatch.
- Open on Watch
Find ShopSync in your watch's app drawer.
-
Use Lists
-
Scroll through lists with the rotary dial
- Tap items to complete/uncomplete them
- View list details and categories
!!! note "WearOS Limitations" You can only view and complete items on your watch. Use your phone or web app to create, edit, or delete items.
First Steps¶
1. Create Your First List¶
After signing in, create your first shopping list:
- Tap the floating action button (+ icon)
- Enter a name for your list (e.g., "Weekly Groceries")
- Optionally, choose a color
- Tap Create
2. Add Items¶
Add items to your list:
- Open your list
- Tap the Add Item button
- Enter the item name
- Optionally:
- Set quantity
- Choose a category
- Add notes
- Select an icon
- Tap Add
Smart Suggestions
As you type, ShopSync will suggest items and automatically select appropriate icons!
3. Share Your List¶
Collaborate with others:
- Open your list
- Tap the share icon (top right)
- Share via:
- Direct link
- Text message
- Other apps
- Recipients can view and edit the list in real-time
4. Check Off Items¶
As you shop:
- Tap the checkbox next to each item
- Checked items move to the bottom
- Everyone sharing the list sees updates instantly
Essential Features¶
Offline Mode¶
ShopSync works without internet:
- ✅ View all your lists
- ✅ Add and edit items
- ✅ Check off items
- ✅ Changes sync automatically when back online
No Internet Indicator
When offline, you'll see an indicator in the app. Your changes are saved locally and will sync once you're back online.
Categories¶
Organize items by category:
- Produce
- Dairy
- Meat
- Bakery
- Pantry
- Frozen
- Beverages
- And more!
Categories help you shop efficiently by grouping related items.
List Groups¶
Organize multiple lists:
- Long-press a list on the home screen
- Select Move to Group
- Create a new group or choose an existing one
Example groups:
- Grocery Stores
- Home Projects
- Gift Ideas
Recycle Bin¶
Recover deleted items:
- Open Settings → Recycle Bin
- View deleted items and lists
- Tap Restore to recover
- Items are permanently deleted after 30 days
Common Tasks¶
Editing Items¶
- Tap an item in your list
- Modify any details
- Tap Save
Deleting Items¶
=== "Single Item" 1. Swipe left on the item 2. Tap Delete
=== "Multiple Items" 1. Long-press an item to enter selection mode 2. Tap other items to select 3. Tap the delete icon
Changing Themes¶
- Open Settings
- Tap Theme
- Choose:
- Light
- Dark
- System Default
Exporting Lists¶
- Open a list
- Tap menu (⋮) → Export
- Choose format:
- Text
- CSV
- Share via any app
Tips for Success¶
Keep Lists Focused
Create separate lists for different stores or purposes rather than one mega-list.
Use Categories
Assign categories to items to navigate your store more efficiently.
Share Smart
Share lists with people who will actively use them. You can always unshare later.
Check Often
Keep ShopSync open while shopping to see real-time updates from family members.
Use Icons
Icons make items easier to identify at a glance while shopping.
What's Next?¶
Now that you're up and running:
Happy shopping!
