1. Getting started
Shopping List by CJ is a free web app — there's nothing to buy, no sign-up, and no account to create. Just open it in your browser and start building your first list.
Installing it like a real app
Shopping List by CJ is a Progressive Web App (PWA), which means you can install it to your phone or desktop so it opens instantly, works offline and feels like a native app — no app store required.
- Android & desktop Chrome: open the app and look for the Install App card on the My Lists screen, or the install icon in your browser's address bar. Tap it and confirm.
- iPhone & iPad (Safari): tap the Share icon in Safari's toolbar, scroll down and tap Add to Home Screen, then tap Add. The app also walks you through these steps on the My Lists screen.
Once installed, the app keeps working even with no signal — handy for supermarkets with patchy reception.
2. My Lists
My Lists is the home screen — it's where all your shopping lists live. Each card shows the list's name, an estimated total based on what's in it, the budget you've set, and how much of that budget is remaining.
Creating a list
Tap + New List and set:
- List name — e.g. "Weekly Shop", "Mum's", "BBQ Sunday".
- Icon — a small picture to help the list stand out (shopping cart, home, party, and more).
- Colour — orange, gold or sage.
- Budget — how much you're aiming to spend on this list.
There's no limit on how many lists you can have — keep one for the weekly groceries and separate ones for anything else you shop for.
As you tick items into a list, its card updates automatically: the progress bar fills up as your estimated total gets closer to your budget, and turns to a warning colour if you go over.
3. Your product catalogue
The Products tab is your personal catalogue — every item you've ever added to the app, all in one place. It starts empty on purpose, so it only ever fills up with things you actually buy, rather than a generic list of thousands of products you'll never use.
From the Products tab you can:
- Search your catalogue with the search bar.
- Filter to ⭐ Favourites only.
- Tap any product to add or remove it from the list you're currently working on.
- Use Add Favourites to drop every favourited product into the current list in one tap.
4. Adding & editing products
Tap + Add Product from either the My Lists or Products screen to open the product form. You can fill this in manually, or use the search shortcut first.
Search Store Page Direct
Pick Aldi, Coles or Woolworths, type what you're after, and tap ↗ Search Web to jump straight to that store's website in a new tab — handy for checking the current price before you enter it.
Product details
- Item name — e.g. "Bananas".
- Category — the aisle it belongs to, used to group items in Shopping mode.
- Store — Aldi, Coles or Woolworths.
- Price & quantity — price is optional, but it's what powers your budget tracking.
To edit a product later, tap the pencil 🖊️ icon next to it in your catalogue. To remove one, delete it from the catalogue — note that pinned items are protected and can't be deleted until you unpin them first (see below).
5. Building your weekly list
With products in your catalogue, building a week's shop is just a matter of tapping the ones you need from the Products tab. Tapping a product adds it to your active list; tapping it again removes it. Use the quantity controls to bump the amount up or down.
The Estimated Total bar at the top of the Products screen updates live as you add and remove items, so you always know roughly where you stand before you even get to Shopping mode.
6. Favourites & pinning
Two small icons sit next to each product in your catalogue, and they do different jobs:
- ⭐ Favourite — marks a product you buy often, so it shows up in the Favourites filter and can be bulk-added with Add Favourites. Favouriting doesn't change where the item sits in the list — your catalogue always stays in alphabetical order.
- 📍 Pin — locks a product against accidental deletion. A pinned item can't be removed by the Delete Unpinned Catalogue tool in Settings, so it's a good way to protect your regulars. Tap the pin icon again (now shown as ❌) to unpin it.
7. Shopping mode
Once your list is built, tap Start ▶ to switch into Shopping mode — a distraction-free, tap-to-check view designed for walking the aisles rather than staring at a spreadsheet.
- Items are grouped by aisle/category, so you can work through the shop in order.
- Use the store filter bar (All / Aldi / Coles / Woolworths) to focus on one store at a time if your list spans more than one.
- Tap an item to check it off. The progress bar and "X of Y collected" counter at the top track how far through the shop you are.
- When everything's ticked, you'll see a "🎉 Trolley's full!" banner.
- ← Edit List takes you back to the Products view if you need to add or remove something. Shop Done wraps up the run.
8. Budget tracking
Every list has its own budget, set when you create it (editable any time). As you add priced items, the app calculates an estimated total and shows you how much budget you have left — right on the list card and again at the top of the Products screen.
If your estimated total goes over budget, the progress bar changes colour so it's obvious at a glance. This is an estimate based on the prices you've entered, not a live receipt total — it's there to help you plan, not to replace checking the till.
9. Backup & restore
Because your data lives on your device (see Your data & privacy below), it's worth backing up before you clear your browser data, switch devices, or just for peace of mind. From Settings:
- 💾 Backup Shopping Data — exports your entire catalogue, lists, favourites, pins and budgets to a
.jsonfile you can save anywhere. - 📥 Restore Shopping Data — pick a previously exported backup file to restore. This replaces your current data after you confirm, so double-check you've got the right file first.
10. Settings & appearance
Tap the ⚙️ icon (top-right of the app) to open Settings, where you'll find:
- ⬆ Check for Updates — manually check you're on the latest version. The app will also show an "Update Now" banner automatically when a new version is ready.
- Appearance — switch between Light, Dark, or System Default (matches your device's setting).
- About — the app's Privacy Policy and open-source Licences.
- Support — buy the developer a coffee or get in touch (see Feedback & support below).
- Danger Zone — Delete Unpinned Catalogue clears out everything except pinned items. Handy for a fresh start, but there's no undo, so back up first if you're not sure.
11. Your data & privacy
Shopping List by CJ doesn't require an account and doesn't upload your shopping lists anywhere. Everything — your catalogue, lists, favourites, pins and budgets — is stored locally on your device using your browser's local storage.
This has a couple of practical side effects worth knowing: your data is tied to the specific browser and device you used it on (it won't automatically appear on a second phone or a different browser), and clearing your browser's site data will remove it. That's exactly what the Backup & Restore feature above is for.
For the full details, read the Privacy Policy.
12. Feedback & support
This app is built and maintained by one person, and tester feedback genuinely shapes what gets fixed and built next. If something breaks, feels confusing, or you've got an idea for a feature, get in touch:
Email: support@shoppinglistbycj.app
Prefer to leave a rating or a quick public review instead? Head to the Feedback & Reviews page — reviews are checked before they go live.
If you're enjoying the app and want to chip in towards its development, there's a Buy Me a Coffee link in the app's Settings and on the homepage — completely optional, always appreciated.
13. Troubleshooting & FAQ
The app doesn't seem to have my latest data
Data is stored per-browser, per-device (see Your data & privacy). If you're opening the app somewhere new, use Restore from a backup you exported earlier.
I deleted something by accident
There's no undo for deletions or restores, which is why regular backups are worth doing — especially before using Restore or Delete Unpinned Catalogue in Settings.
A product I want to delete won't go away
It's probably pinned. Tap the pin icon (shown as ❌ once pinned) to unpin it, then delete as normal.
Does it work without internet?
Yes — once installed, the app is offline-first and will keep working without a connection. You only need the internet for the optional "Search Store Page Direct" web search and for checking app updates.
Is it really free?
Yes, no catches. If you'd like to support development, there's an optional Buy Me a Coffee link in Settings.