Documentation
Everything you need to get started with Larder.
Quick start
Open the app
Go to larder-theta.vercel.app in any browser, including your phone.
Create a free account
Click Sign up, enter your email and a password. No credit card needed.
Scan your first receipt
Click the 📸 camera button, upload a photo of a grocery receipt, and watch your pantry fill up automatically.
Scanning a receipt
Larder uses Claude AI to read your receipt and extract each item, its estimated quantity, and its expected shelf life.
Supported formats
| Format | Supported? |
|---|---|
| JPEG / JPG photo | ✅ Yes |
| PNG screenshot | ✅ Yes |
| WebP (from web) | ✅ Yes |
| GIF | ✅ Yes |
| PDF (digital receipt) | ✅ Yes |
| Excel (.xlsx) | ✅ Yes |
| Word (.docx) | ✅ Yes |
| CSV / TXT | ✅ Yes |
Tips for best results
- •Lay the receipt flat and shoot straight down
- •Good lighting helps — avoid heavy shadows
- •The full receipt doesn't need to be in frame — item lines are what matter
- •Uploads are capped at 10 MB
Pantry management
Edit an item
Hover over any item row and click the ✏️ button. A modal opens with the item pre-filled — change the name, quantity, unit, category, or expiry date and click Save.
Delete an item
Hover over any item row and click the 🗑 button. The item is soft-deleted — removed from your pantry view, but the history is kept for your records.
Use one unit
Click the [ − ]button on the left of an item row to use one unit. "3 pints" becomes "2 pints." When the last unit is used, the item is marked as consumed and removed from the pantry.
Mark as used (all at once)
The Used button removes the entire item at once. Perfect when you finish a whole container.
Filter by category
Click any category pill at the top of the pantry (Produce, Dairy, Meat, etc.) to filter the list. Click again to clear.
Expiry alerts
Larder automatically flags items as they age. The freshness bar under each item changes color over time:
A red alert strip appears at the top of your pantry when any item is within 3 days of expiry or already expired. It lists the item names so you can act fast.
A nightly job runs at 2am EST to update expired item statuses. Expired items stay visible in your pantry with a red "Expired" badge — they only disappear when you remove them manually.