How randakamal/kartli works
kartli is a shared-kitchen and household app: members create or join a space, manage its shared shopping list and pantry, then record purchases and split costs. The repository also documents receipt scanning and matching, refunds, guest shopping, analytics, invitations, push notifications, themes, and English/German localization. The graph combines sampled page/data-layer references with README-documented capabilities; dashed links mark integrations or wiring not established by the available excerpts.
Main entry points: stats.ts Spending analytics · pantry.ts Pantry inventory · kitchen.ts Kitchen spaces · db.ts PostgreSQL
Components 20
Identity and spaces
- Authentication
auth.ts - Accounts
lib/auth-service.ts - Invitations
lib/invite.ts - Kitchen spaces
lib/kitchen.ts - Kitchen workspace
components/KitchenSpaceView.tsx - Kitchen dashboard
app/dashboard/page.tsx
Shopping and pantry
- Pantry inventory
lib/pantry.ts - Pantry controls
components/PantrySection.tsx - Shopping list
components/ActiveCartSection.tsx - Guest shopping
components/kitchen/GuestView.tsx
Checkout and insights
- Purchase checkout
app/actions/checkout.ts - Receipt scanning
app/actions/scan-receipt.ts - Receipt matching
lib/receipt-normalizer.ts - Refund review
components/AdminRefundsSection.tsx - Spending analytics
lib/actions/stats.ts
Shared platform
- PostgreSQL
lib/db.ts - Gemini Vision
- Push notifications
lib/push.ts - Localization
lib/i18n/context.tsx
Other components
- Household member
Connections 26
- Household member → Kitchen dashboard: opens
README.md - Kitchen dashboard → Kitchen spaces: loads spaces
app/dashboard/page.tsx - Kitchen dashboard → Kitchen workspace: renders
app/dashboard/page.tsx - Household member → Authentication: signs in
README.md - Authentication → Accounts: authenticates
app/actions/auth.ts - Household member → Invitations: joins by link
- Invitations → PostgreSQL: reads and writes
lib/invite.ts - Kitchen spaces → PostgreSQL: reads and writes
lib/kitchen.ts - Kitchen workspace → Pantry inventory: manages inventory
- Household member → Pantry controls: updates stock
README.md - Pantry inventory → PostgreSQL: reads and writes
lib/pantry.ts - Pantry inventory → Kitchen spaces: checks admin role
lib/pantry.ts - Pantry controls → Shopping list: adds out-of-stock items
README.md - Household member → Guest shopping: shares guest link
README.md - Household member → Purchase checkout: records purchase
README.md - Purchase checkout → Pantry inventory: records checkout
- Household member → Receipt scanning: scans receipt
README.md - Receipt scanning → Gemini Vision: extracts items
- Receipt scanning → Receipt matching: matches items
- Purchase checkout → Refund review: submits for review
- Household member → Spending analytics: views spending
README.md - Spending analytics → Kitchen spaces: checks membership
lib/actions/stats.ts - Spending analytics → PostgreSQL: queries spending
lib/actions/stats.ts - Spending analytics → Receipt matching: normalizes stores
lib/actions/stats.ts - Household member → Push notifications: enables alerts
README.md - Household member → Localization: selects language
README.md