How ankit-iiitkota/billbuddy works
BillBuddy is a real-time expense-splitting app: users authenticate, create groups or track expenses with individuals, record split details, and review balances and settlements. The dashboard and group/person views present spending and debt state; Convex provides the backend and database. Scheduled reminders and spending insights are represented from the documented Inngest modules and route imports, but their full execution flow was not inspected. The graph emphasizes evidenced UI calls and documented capabilities; unsampled backend relationships are left out where wiring is uncertain.
Main entry points: [id]/page.jsx Group details · use-convex-query.js Convex query hooks · schema.js Convex database · [id]/page.jsx Person details
Components 24
User experience
- Authentication
app/(auth)/sign-in/[[...signIn]]/page.jsx - Landing page
app/page.jsx - Dashboard
app/(main)/dashboard/page.jsx - Contacts and groups
app/(main)/contacts/page.jsx
Expense domain
- Expense entry
app/(main)/expenses/new/components/expense-form.jsx - Group details
app/(main)/groups/[id]/page.jsx - Person details
app/(main)/person/[id]/page.jsx - Settlement entry
app/(main)/settlements/[type]/[id]/components/settlement-form.jsx - Expense list
components/expense-list.jsx - Settlement list
components/settlement-list.jsx - Group balances
components/group-balances.jsx
Convex backend
- Convex query hooks
hooks/use-convex-query.js - Convex functions
convex/expenses.js - Group functions
convex/groups.js - Dashboard functions
convex/dashboard.js - Settlement functions
convex/settlements.js - Contact functions
convex/contacts.js - Convex database
convex/schema.js
Automation
- Inngest endpoint
app/api/inngest/route.js - Payment reminders
lib/inngest/payment-reminders.js - Spending insights
lib/inngest/spending-insights.js
Other components
- User
- Inngest service
- Clerk auth
Connections 30
- User → Landing page: visits
README.md - User → Authentication: authenticates
README.md - Authentication → Clerk auth: authenticates with
README.md - User → Dashboard: tracks spending
README.md - Dashboard → Convex query hooks: queries through
app/(main)/dashboard/page.jsx - Dashboard → Dashboard functions: requests summaries
app/(main)/dashboard/page.jsx - Contacts and groups → Convex query hooks: queries through
app/(main)/contacts/page.jsx - Contacts and groups → Contact functions: manages contacts
app/(main)/contacts/page.jsx - User → Expense entry: enters expense
README.md - Expense entry → Convex query hooks: submits through
app/(main)/expenses/new/components/expense-form.jsx - Expense entry → Convex functions: records expense
app/(main)/expenses/new/components/expense-form.jsx - Group details → Convex query hooks: queries through
app/(main)/groups/[id]/page.jsx - Group details → Group functions: loads group data
app/(main)/groups/[id]/page.jsx - Group details → Group balances: renders balances
app/(main)/groups/[id]/page.jsx - Group details → Expense list: renders expenses
app/(main)/groups/[id]/page.jsx - Group details → Settlement list: renders settlements
app/(main)/groups/[id]/page.jsx - Person details → Convex query hooks: queries through
app/(main)/person/[id]/page.jsx - Person details → Expense list: renders expenses
app/(main)/person/[id]/page.jsx - Person details → Settlement list: renders settlements
app/(main)/person/[id]/page.jsx - User → Settlement entry: records payment
README.md - Settlement entry → Convex query hooks: submits through
app/(main)/settlements/[type]/[id]/components/settlement-form.jsx - Convex functions → Convex database: reads and writes
- Group functions → Convex database: reads and writes
- Dashboard functions → Convex database: reads
- Settlement functions → Convex database: reads and writes
- Contact functions → Convex database: reads and writes
- Inngest endpoint → Payment reminders: registers
app/api/inngest/route.js - Inngest endpoint → Spending insights: registers
app/api/inngest/route.js - Payment reminders → Inngest service: runs on
- Spending insights → Inngest service: runs on