🧺 Larder
Larder is an AI-powered inventory tracker that turns grocery receipts into a smart kitchen. Upload a photo of any receipt and Claude AI extracts every item — name, quantity, category, price, and estimated shelf life — into a pantry view that warns you before things expire. The average US household wastes ~$1,500 of food a year; Larder helps you fix that.
A production full-stack application built with Next.js 16 + React 19 on the frontend, FastAPI + Python on the backend, Supabase (Postgres + JWT auth) for data and identity, and Anthropic Claude for AI-powered receipt parsing. Deployed across Vercel and Render with GitHub Actions CI/CD.
📸 Screenshots
Screenshots are checked into docs/screenshots and captured from the local production builds with a seeded demo pantry session.
| Pantry dashboard | Expiring soon |
|---|
| |
🎯 What this project demonstrates
A complete end-to-end product built solo — frontend, backend, database, auth, AI integration, DevOps, and design.
| Area | Where it lives |
|---|
| Frontend engineering | 3 Next.js 16 App Router apps (web + marketing + docs), 11 routes, ~3,500 LOC of TypeScript/React |
| Backend engineering | FastAPI service with 10 endpoints, Pydantic v2 validation, dependency injection, lifespan hooks |
| Authentication & security | Supabase JWT (ES256) verification with JWKS, key-rotation fallback, type-email-to-confirm flows for destructive actions |
| Database design | Postgres schema with soft deletes, status state machine, re-purchase inference, indexed queries |
| AI / ML integration | Claude vision API for receipt parsing, structured JSON extraction, shelf-life estimation |
| DevOps & deployment | Three independent deploy targets (2× Vercel, 1× Render), explicit CORS allowlist via FRONTEND_URL, env-var-driven config |
| CI/CD | GitHub Actions: ruff lint, Next.js typecheck, auto-merge on green with retry loop |
| Product & UX design | Warm earthy design system, Notion-style sidebar, Headspace-inspired marketing site, animated mockups |
| Compliance | GDPR-friendly account deletion (cascades pantry + receipts + auth user), public privacy policy |
🔗 Live links
✨ Features
Core
- 📸 Receipt scanning — upload photo, PDF, Excel, Word, CSV, or TXT; Claude AI extracts every item with name, quantity, unit, category, price, and estimated shelf life
- 🥦 Smart pantry — items auto-grouped by category with color-coded freshness bars
- ⏰ Expiry tracking — three-tier urgency system (red / amber / green) + dedicated
/expiring page grouped into Expired / Today / Next 3 days
- 🔔 Live sidebar badge — fetches expiring count on every route change
- ➕ Manual add — for items without a receipt
- 🔍 Search & sort — real-time text search + Expiry / Name / Recent sort
- ✏️ Item details modal — click any item to see purchase date, days since added, shelf life, and full metadata
- 📉 Decrement & consume — track partial usage or mark fully used in one tap; uses Postgres atomic updates
Auth & account
- 🔑 Email/password sign up & sign in via Supabase (ES256 JWTs with HS256 dev fallback)
- 🔄 Password reset flow with secure email link +
PASSWORD_RECOVERY event handling
- ⚙️ Settings page — profile, change password, sign out
- 🗑️ Account deletion — type-email-to-confirm; cascades deletion of pantry, receipts, and auth user (GDPR-compliant)
- 📄 Public privacy policy page
Marketing site
- Animated hero with two product preview cards
- Scroll-triggered fade/slide animations (IntersectionObserver)
requestAnimationFrame-based count-up stats- CSS
@keyframes marquee ticker strip
- Tabbed feature showcase, FAQ accordion, auto-rotating testimonials
🤖 AI / LLM integration
Larder treats Claude as a first-class component, not a wrapper.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
